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PREFACE 


This manual is dedicated to the many individuals associated 
with the Timex Computer Corporation in the development and 
production of the TS2068. Our special thanks to Nan Parsons 
who prepared the TS2068 Schematic and other drawings used 
in this manual. 


While every effort has been made to make this document 
complete and accurate, use of the technical information 
contained herein is at user's sole risk. The Timex Corp. or 
its affiliates, and Time Designs Magazine Company assume no 
responsibility or liability for the safety or performance 
of any product manufactured relying on the technical data 
contained herein, or any liability, loss, damage, or 
expense sustained by reason of any claim that such products 
infringe any patent or other industrial property right. 


The Second Edition of this Technical Manual has been re- 
edited by Tim Woods. Special thanks to Bob Orrfelt and Dave 
Clifford for technical assistance. 


If you would like to receive information on a magazine and 
other publications for the Timex Sinclair 2068, direct your 
inquiry to: Time Designs Magazine Company, 29722 Hult Rd., 
Colton, OR 97017. 
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1.0 


INTRODUCTION 


This manual provides detailed technical information on the Timex 
Sinclair 2068 Personal Color Computer. In conjunction with the 1TS2068 
User Manual, it is intended to assist the reader in understanding the 
architecture, hardware and software features, programming techniques 
and 1/0 techniques pertaining to the TS2068. 


1.1 TS2068 Overview 
1.1.1 Hardware Overview 
Figure 1.1-] is a block diagram of the TS2068 showing the 
major functional components and their logical 
connections. These components are: 


Control Logic - SCLD (Standard Cell Logic Device) 


CPU - Z80A Microprocessor 
RAM - 48K Random Access Memory 
ROM ~ 24K System Read-Only Memory 


(16K plus 8K Extension) 


System Bus Connector 
Cartridge Connector 
Sound Generator/Speaker 
Video Circuits 

Cassette READ/WRITE 
Joystick Connectors 


The TS2068 Cartridge Connector provides for the plug-in 
of cartridges containing programmed ROM's with up to 64K 
of addressable memory. The full 64K jis not normally 
utilized (e.g., due to need for access to RAM for the 
machine stack). See Section 5.1 for details. 


Figure 1.1-2 shows the standard 1S2068 memory 
configuration comprised of the Home Bank, the ROM 
Extension Bank and the Dock (Cartridge) Bank. This 
memory is selectable as eight 8K ‘chunks’ with the Home 
Bank being enabled by default, i.e., any chunk not 
selected in the Extension or Dock Bank is automatically 
enabled in the Home Bank. 


Memory selection and I/0 are controlled via the I/0 
ports. These topics are covered in detail in later 
sections. 


FIGURE 1.1-1 
TS 2068 SYSTEM BLOCK DIAGRAM 
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FIGURE 1.1-2 
TS 2068 STANDARD MEMORY CONFIGURATION 
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System Software Overview 


The TS2068 System Software resides in the Home ROM, the 
Extension ROM, and dedicated RAM. It supports the 
following functions: 


System Initialization 


BASIC Interpreter (including BASIC cartridge support) 


BASIC I/0 for Standard Peripherals 


keyboard 

video screen 

2040 32-col. dot matrix printer 
cassette tape 

joysticks 

software generated sound (BEEP) 
programmable sound chip (SOUND) 


eooooo0c90 


- Video Mode Change Service 


Interruption Servicing (Z80 Int. Mode 1) 


Bank Switching/Data Transfer Services 


Function Dispatcher (provides access to selected system 
routines via a Service Code input) 


In addition, portions of the Home Bank RAM are used for 
the machine stack, the BASIC system variables, the 
Printer Buffer and the Display Files. Figure 1.1-3 shows 
the standard mapping of the Home Bank RAM and the mapping 
necessary when the second display file is to be used with 
the BASIC interpreter still functional. The Video Mode 
Change Service routine makes these memory modifications. 
Note that there is no direct support of the second 
display file via BASIC or in the system ROM I/0 routines. 


Figure 1.1-4 is a Flowchart of the System Initialization 
process. 


FIGURE 1.1-3 
STANDARD MAPPING OF 
HOME BANK RAM 
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FIGURE 1.1-4 
SYSTEM INITIALIZATION 
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Cartridge Software Overview 


The 1S2068 supports two basic types of Cartridge or 
ROM-Oriented Software designated as LROS (Language 
ROM-ORiented Software) and AROS (Application ROM-Oriented 
Software) which plug into the cartridge connector. They 
are identified via overhead bytes at Location 0 for an 
LROS or 32768 (8000H) for an AROS. The fundamental 
difference is that an LROS contains Z80 machine code in 
memory chunk 0 and is in total control of the 1TS2068 
hardware including the RESTART implementation and 
Interruption Mode setting and handling, while an AROS is 
dependent on the System ROM or an LROS for these 
functions if needed. An AROS written jin BASIC, which may 
also include machine code accessed via the USR function, 
is supported from the System ROM BASIC Interpreter and is 
mapped beginning in memory chunk 4. An AROS may also be 
written entirely in Z80 machine code. An AROS written in 
any other high-level language would require an LROS 
supporting that language and would have to be integrated 
with the LROS in a single cartridge. 


See Sections 3.2.1.2, BASIC AROS Support and 5.1, 
Cartridge Software/Hardware, for additional details. 


2.0 HARDWARE GUIDE 
2.1 Description of Major Hardware Functions 


Figure 1.1-1 shows a simplified block diagram of the TS2068. The 
following functional units are described in the following 


Sound Generator 
Joystick Port 
Control Logic 


sections: 

SECTION FUNCTIONAL UNIT 
.] AC Adapter 
«2 Voltage Regulation 

1.3 Z-80A CPU 
3.1] Address 8us 
3.2 Data Bus 
3.3 Control Signals 
3.4 OP Code Fetch 
«3.5 Memory READ/WRITE 
.3.6 1/0 READ/WRITE 
coed Maskable Interruption 
.3.8 Non-Maskable Interruption (NMI) 
4 ROM 
2125 32K RAM 

.6 
ot 
8 
0% 
“8s 
8. 
«Bs 
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7 Bank Selection Logic 
2 Z80 Clock Generator 
3 Display File Access 
4 Interruption Generation 
Keyboard 

10 16K Video Display RAM 

11 Video Generation 

17.1 Composite Video 

11.2 RF Modulator 

12 Cassette I/0 

13 Port Map 


2.1.1 


AC Adapter 


The AC Adapter transforms 117¥ AC (Nominal) to filtered 
DC via a step down transformer, full-wave bridge 
rectifier, and filter capacitor to supply from 14 to 25 
volts at 7 amp over the AC voltage variation range of 105 
to 130 V AC. Transformer isolation exceeds 1500 volts. 


117Vv 
AC 60Hz 
14 to 25v 
TL DC 


2.162 


14 to 
Dc 


Voltage Regulation 


Unregulated DC from the AC Adapter is supplied for 
regulation through a bi-filar torroidal inductor which 
reduces conducted line emanation for FCC compliance and 
through the power-ON/OFF switch located on the left side 
of the 1TS2068. This switch voltage fs supplied to the 
System Bus Connector (see Section 2.4) and for regulation 
to the +12 V_ regulator and the +5 V_ regulator. 
Characteristics are as follows: 


SUPPLY VOLTAGE RANGE CURRENT RANGE 


5V 4.75 - 5.25V 200ma - 1.0 A 
12V 11.5 - 12.5V 20ma ~ 100ma 
» +20V 
wn. +5v 
25v REGULATOR 
+1l2v 
GND 


The 12V regulator is a 78L12 series regulator while the 
5V regulator is a switching supply utilizing the 78540 
circuit. 


2.1.3 Z-80A CPU 


The Z-80A CPU of the 1TS2068 operates at a clock frequency 
of 3.53 MHz. Primary features of this CPU are: 


158 instructions 

Dual register set 

Two index registers 
On-chip refresh logic 


The Z-80 CPU executes instructions by proceeding through 
a sequence of operations that include: 


a) instruction Op code fetching 
b) READ or WRITE memory 

c) READ or WRITE I/0 

d) Acknowledge an interruption 


The basic clock period is referred to as a T time or 
state and three or more T states make up a machine 
cycle. In the TS2068, each T-time is approximately 283 
nanoseconds (2.83 X 107-/ seconds). Figure 2.1.3-1 
illustrates the basic timing. 


FIGURE 2.1.3-1 


BASIC CPU TIMING EXAMPLE 


(OP Code Fetch) 


{Memory Read} (Memory Write! 


instruction Cycle 


2.1.3.1 


2.1.3.2. 


2.1.3.3 


2.1.3.4 


2.1.3.5 


Address Bus 


Output from the Z-80 are 16-bits of address 
information, AO - A15, which are high-active 
tri-state signals and address for memory data 
and I/0 device exchanges. 


Data Bus 


These input/output signals from the Z-80, DO - 
D7, constitute an  8-bit bi-directional, 
high-active, tri-state data bus used for data 
exchanges with memory and I/0 devices. 


Contro? Bus 


Associated with the Z-80 are 13 control lines 
which are provided by or used by the Z-80 to 
control system operation. These signals are 
detailed in Table 2-1. 


Op Code Fetch 


The timing during an M1 cycle (OP Code Fetch) 
is shown in Figure 2.1.3-2. At the beginning 
of the Ml cycle the PC (Program Counter) is 
placed onto the address bus, then one-half 
clock time later the MREQ signal goes active 
indicating that the memory address is stable. 
The RD signal jis activated to indicate that 
memory read data should be gated onto the data 
bus. At the rising clock edge during the T3 
state, the CPU samples the data on the data bus 
and deactivates the RD and MREQ signals. 
During the T3 and T4 states, the CPU decodes 
and executes the fetched instruction and the 
CPU places on the lower 7 bits of the address 
bus a memory refresh address and activates the 
RFSH signal indicating a refresh read is to 
begin when MREQ js activated. 


Memory READ/WRITE 


Memory read or write cycles other than Op Code 
Fetches are 3 clock periods long with the MREQ 
and RD signals used as in the fetch cycle. 
During a write cycle the WR signal is activated 
when the write data is stable on the data bus. 
The address and data bus contents remain stable 
for one-half T state after the WR signal goes 
active. Figure 2.1.3-3 illustrates. 
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FIGURE 2.1.3-2 


INSTRUCTION OP CODE FETCH 


FIGURE 2.1.3-3 


MEMORY READ OR WRITE CYCLES 


Memory Reed Cycle 


DATA BUS 
(DO-D7) 


Walt 


ll 


2.1.3.6 1/0 READ/WRITE 


During I/0 operations TORQ and RD or WR are 
activated on the leading edge of the T2 clock 
and a single Wait state is automatically 
inserted as illustrated in Figure 2.1.3-4. The 
RD and WR signals are used to enable data from 
the addressed port onto the data bus and to, on 
the rising edge of WR, clock data to the 1/0 
port, respectively. Note that external I/0 may 
stretch the activation period of the WAIT line 
to extend the I/0 cycles. 


FIGURE 2.1.3-4 


INPUT OR OUTPUT CYCLES 


“inserted by Z80 CPU 
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2.1.3.7 Maskable Interruption 


When enabled by software, when BUSRQ is not 
active and when INT jis active at the rising 
edge of the last clock of any instruction, a 
maskable interruption occurs during the 
subsequent Ml cycle, as illustrated in Figure 
2.1.3-5. 


FIGURE 2.1.3-5 


INTERRUPT REQUEST/ACKNOWLEDGE CYCLE 


Last M Cycle 
of Instruction 


In Interruption Mode 0, the interrupting 1/0 
device places any instruction on the data bus 
during the TORQ activation and the CPU executes 
that instruction. The RESTART instruction is 
commonly used for this purpose. RESET will 
automatically set Interruption Mode 0. 


In Interruption Mode 1, the CPU executes a 
RESTART to Location 0038H. This is the mode 
normally used by the TS 2068 software. 


In Interruption Mode 2, the CPU concatenates 
the 8-bit argument, which must be a 2-byte 
boundary address, with the 8-bit I Register 
contents to form a 16-bit pointer to a memory 
table entry containing the 16-bit service 
routine address - the first byte in the table 
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Mode 0 


being the low order portion of the address. 
Once the interrupting device supplies the lower 
portion of the pointer (for concatenation), the 
CPU automatically pushes the PC onto the stack, 
obtains the starting address from the table, 
and does a jump to that address. 19 clock 
periods are required to complete this sequence. 


2.1.3.8 Non-Maskable Interruption (NMI) 


A pulse on the NMI input to the Z80 sets the 
internal latch which is tested by the CPU at 
the end of each instruction. The NMI has 
priority over the maskable interruption and its 
reponse is identical to the maskable 
interruption (Mode 1) except that the call 
location is O066H instead of 0038H. 


NOTES: 1. The NMI fs not used by the TS 
2068. 


2. Comments in the ROM listing 
claiming to "mask the NMI" via 
the DI instruction are 
incorrect. The DI instruction 
masks only the maskable 
interruption. 
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SYSTEM CONTROL 


ACRONYM 
NT” 


TABLE 2-1 


Z-80 CONTROL SIGNALS 


DEFINITION 


Machine Cycle 1 - Output, active low. This 
signal indicates that the current machine cycle 
is the OP code fetch cycle. During execution 
of instructions having a 2-byte OP code, this 
signal be ee a as each OP code byte is 
fetched. is also used with [ORQ to indicate 
an interrupt acknowledge cycle. 


Memory Request - Tri-state output, active low. 
This signal indicates that the Address Bus 
holds a valid address for a memory read or 
write operation. 


1/0 Request - Tri-state output, active low. 
This signal indicates that the lower half of 
the Address Bus holds a valid I/0 address for 
an 1/0 read or write operation. This signal is 
also used with MT in connection’ with 
acknowledging an interruption, indicating that 
an interrupt response vector can be placed on 
the data bus. 1/0 operations never occur 
during MT time. 


Memory Read - Tri-state output, active low. 
This signal indicates that the CPU wants to 
read data from memory or an I/0 device. The 
addressed memory or device should use this 
signal to gate the requested data onto the CPU 
data bus. 


Memory Write - Tri-state output, active low. 
This signal indicates that the CPU data bus 
holds valid data to be stored in the addressed 
memory or I/0 device. 


Refresh - Output, active low. This signal 
indicates that the lower 7 bits of the Address 
Bus contain a refresh address for dynamic 
memories and the current MREQ signal should be 
used to do a refresh read to all dynamic 
memories. A7 is a logic zero and the upper 8 
bits of the Address Bus contain the contents of 
the I Register. 
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TABLE 2-1 
Z80 CONTROL SIGNALS 


(continued) 
ACRONYM DEFINITION 
CPU CONTROL HALT Halt State - Output, active low. This signal 


indicates that the CPU has executed a HALT 
instruction. CPU operations are suspended 
until a Non-Maskable or a Maskable Interruption 
(with the mask enabled) occurs. While halted, 
the CPU executes NOP's to maintain memory 
refresh. 


WAIT Wait - Input, active low. This signal 
Tndicates to the CPU that the addressed memory 
or 1/0 device is not ready for a data 
transfer. The CPU will continue to enter wait 
states as long as this signal is active. This 
allows for synchronization of the CPU to 
external devices of varying speeds. — 


INT Interrupt Request - Input, active low. This 
signal 1s generated by external devices and is 
honored at the end of the current instruction 
if the interrupt is not masked by the software 
and if the BUSRQ signal is not active. When 
the CPU accepts the interruption, an 
acknowledge signal is sent out at the beginning 
of the next instruction cycle (TORQ at Ml 
time). There are three interruption modes 
selectable by the software. 


WAT Non-Maskable Interruption - Input, negative 
edge triggered. This signal has a higher 
priority than INT and is always recognized at 
the end of the current instruction (cannot be 
masked). The CPU jis forced to restart to 
location 0066H with the program counter saved 
in the external stack. NOTE: The NMI fs not 
used in the TS2068 ROM software design. 
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CPU BUS CONTROL 


ACRONYM 


RESET 


BUSRO- 


BUSAK 


TABLE 2-1 


Z80 CONTROL SIGNALS 
(continued) 


DEF INITION 


Reset - Input, active Tow. This signal forces 
the program counter to zero and initializes the 
CPU. Address and data buses go to their high 
impedance state and control output signals to 
their inactive state. No refresh occurs. 
Initialization includes: Disable the interrupt 
enable flip-flop and set Register I, Register R 
and the Interrupt Mode all to Zero. 


Bus Request - Input, active low. This signal 
Ts used to request the CPU address bus, data 
bus and tri-state output control signals to go 
to a high impedance state permitting other 
devices to control these buses. The CPU sets 
these buses to a high impedance state at the 
termination of the current Machine cycle. 


Bus Acknowledge - Output, active low. This 
signal 1s aged to indicate to the requesting 
device that the CPU has set its address, data 


and control bus signals to a high impedance 
state in response to BUSRQ. 


Figure 2.1.4-1 


REWORK TO REPLACE ROM's with EPROM's 
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2.1.4 


2.1 


5 


ROM 


The system includes both a 16K byte ROM and an 8K byte 
ROM mapped into the address space as shown below. 


3FFFh 
(U16) 
16K 
ROM 
1FFFh . 
(U20) 
8K 
ROM 
0000h 0000h 
HOME BANK EXPANSION BANK 


Section 2.1.8.1 describes the selection of the Home Bank 
and Expansion Bank via the control logic. 


The devices involved are a 23128 and a 2364 for the 16K 
byte (128K-bit) and the 8K byte (64K-bit) ROM's 
respectively. Direct replacement of these devices with 
27128 and 2764 EPROM's is not possible since pins 1 and 
27 must be maintained in the high state for those devices 
(see schematic in Section 2.2). To replace U16 and U20 
with 27128 and 2764 EPROM's requires the rework shown in 
Figure 2.1.4-1. 


(1) Cut input to pin 27 on each chip. 
(2) Wire +5V to pins 1 and 27 on each chip to pull high. 


If U20 is to be a 27128, then replace the RD input to pin 
26 with address A13 from pin 26 on U16. 


32K RAM (Address 8000-FFFFH) 


The upper 32K of RAM is composed of four 200ns 4416's 
(16K x 4 dynamic RAMs). | 
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2.1.6 Sound Generator 


The Programmable Sound Generator (GI 8912) is accessed via Ports 
OF5H (Address) and OF6H (Data). The basic registers in the PSG 
which produce the programmed sounds include: 


Tone Generators: Produce the basic square wave tone frequencies 


for each channel (A, B, C). 


Noise Generator: Produces a frequency modulated pseudo-random 


pulse width square wave output. 


Mixers: Combine the outputs of the Tone Generators and the Noise 
Generator. One for each channel (A, B, C). 


Amplitude Control: Provides the D/A Converters with either a 
fixed or variable amplitude pattern. The fixed amplitude jis 
under direct CPU control; the variable amplitude is accomplished 
by using the output of the Envelope Generator. 


Envelope Generator: Produces an envelope pattern which can be 
used to amplitude modulate the output of each Mixer. 


D/A Converters: The three D/A Converters each produce up to a 
Té-TeveT output signal as determined by the Amplitude Control. 


An additional register is shown in the PSG Block Diagram (Figure 
2.1.6-1) which has nothing directly to do with the production of 
sound -- this is the I/0 Port (A). Data to/from the CPU may be 
read/written to/from the 8-bit I/0 Port without affecting any 
other function of the PSG. The TS 2068 uses the I/0 Port to 
access the joysticks. 


2.1.6.1 Tone Generator Control (Registers RO-R5) 


The frequency of each square wave generated by the three Tone 
Generators (one each for Channels A, B, and C) is obtained in the 
PSG by first counting down the input clock by 16, then by further 
counting down the result by the programmed 12-bit Tone Period 
value. Each 12-bit value is obtained in the PSG by combining the 
contents of the relative Coarse and Fine Tune registers, as 
illustrated by Figure 2.1.6-2. 


Note that the 12-bit value programmed in the combined Coarse and 
Fine Tune registers is a period value -- the higher the value in 
the registers, the lower the resultant tone frequency. 


Note also that due to the design technique used in the Tone 
Period countdown, the lowest period value is 000000000001 (divide 
by 1) and the highest period value is 111111111111 (divide by 
4095). 
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FIGURE 2.1.6-1 
PSG REGISTER BLOCK DIAGRAM 
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FIGURE 2.1.6-2 
12-BIT TONE PERIOD (TP) TO TONE GENERATOR 


COARSE TUNE FINE TUNE 
REGISTER CHANNEL REGISTER 

RI A RO 

R3 B R2 

R5 c Ra 

B7 B6 B5 B4]B3 B2 Bl BO 
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2.1.6.1 (continued) 


The equations describing the relationship between the desired output tone 
frequency and the input clock frequency and Tone Period value are: 


(a) fT = fCLOCK (b) TP = 256CT + FT 
l6TP 10 10 
10 
Where: fT = Desired tone frequency 


fCLOCK = Input clock frequency 


TP = Decimal equivalent of the Tone Period 
10 bits TP11 to TPO 

CT = Decimal equivalent of the Coarse Tune 
10 register bits B3 to BO (TP11 to TP8) 

FT = Decimal equivalent of the Fine Tune 
10 register bits B7 to BO (TP7 to TPO) 


From the above equations, it can be seen that the tone frequency can range 
from a low of: 


FCLOCK/65520 (wherein TP = 4095 ) 
10 10 


to a high of: 


fCLOCK/16 (wherein TP = 1). 
10 


The TS 2068 uses a 1.76475 MHZ input clock, so it can produce a range of 26.9 
Hz to 110 kHz. 
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2.1.6.1 (continued) 


To calculate the values for the contents of the Tone Period Coarse and Fine 
Tune registers, given the input clock and the desired output tone frequencies, 
we simply rearrange the above equations, yielding: 


(a) TP = fCLOCK (b) CT +fFT = TP 
10 “Té #7 10 10 10 
256 86256 
Example 1: fT = 1 kHZ fCLOCK = 1.76475 MHz 
6 
TP = 1.76475x 10 
10 3 
16(1x10 ) = 110.3 


Substituting this result into equation (b): 


CT +FT = 110.3 
10 10 10 


resulting in: 


CT = 0 = 0000 (B3-B0) 
10 2 
FT = 110 = 01101110 (B7-BO) 
10 10 2 
Example 2: fT = 100 Hz fCLOCK = 1.76475 MHz 
6 
TP = 1.76475x10 
10 2 = 1103 
16(1x10 ) 


Substituting this result into equation (b): 


CT + FT = 1103 
10 10 = 4 + 79/256 
256. 200 


resulting in: 


CT = 4 0100 (B3-B0) 
10 10 2 


FT 79 


01001111 (B7-BO) 
10 10 2 
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2.1.6.2 Noise Generator Control (Register R6) 


The frequency of the noise source is obtained in the PSG by first 
counting down the input clock by 16, then by further counting 
down the result by the programmed 5-bit Noise Period value. This 
5-bit value consists of the lower 5 bits (B4-BO) of Register R6 
as illustrated by Figure 2.1.6-3. 


FIGURE 2.1.6-3 
NOISE PERIOD REGISTER R6 


B Bo BB Ba = B B ; BU 


NOT USED 5-BIT NOISE PERIOD (NP) 
TO NOISE GENERATOR 


Note that the 5-bit value in R6 is a period value -- the higher 
the value in the register, the lower the resultant noise 
frequency. Note also that, as with the Tone Period, the lowest 
period value is 00001 (divide by 1); the highest period value Ts 
11111 (divide by 31). 


10 
The noise frequency equation is: fN = fCLOCK 
10 
Where: fN = Desired noise frequency 
fFCLOCK = Input clock frequency 
NP = Decimal equivalent of the 
10 Noise Period register bits 


B4-B0. 


From the above equation it can be seen that the noise frequency 
can range from a low of fCLOCK/496 (wherein NP =31 ) 
10 10 
to a high of fCLOCK/16 (wherein NP = 1). Using a 1.76475 MHz 
10 


clock, for example, would produce a range of noise frequencies 
from 3.6 kHz to 110.3 kHz. 


To calculate the value for the contents of the Noise Period 
register, given the input clock and the desired output noise 
frequencies, we simply rearrange the above equation, yielding: 


NP = fCLOCK/16fN 
10 
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2.1.6.3 Mixer Control 1/0 Enable (Register R7) 


Register 7 is a multi-function Enable register which controls the 
three Noise/Tone Mixers and the two general purpose I/O ports. 


The Mixers, as previously described, combine the noise and tone 
frequencies for each of the three channels. The determination of 
combining neither/either/both noise and tone frequencies on each 
channel is made by the state of bits B5 thru BO of R7. 
The direction (input or output) of the two general purpose 1/0 
ports (IOA and I0B) is determined by the state of bits B7 and B6 
of R7. Note that in the TS 2068 there is no second I/0 Port B. 
These functions are jfllustrated by Figure 2.1.6-4 and Tables 
2.1.6-1 and 2.1.6-2 below. 

FIGURE 2.1.6-4 


MIXER CONTROL - I/O ENABLE REGISTER R7 


7 | 


TABLE 2.1.6-1 
1/0 ENABLE TRUTH TABLE 


R/ B Noise Enabled R/ 6 one Enabled 
B5 B4 B3 on Channel B2 Bl BO on Channel 


0 
0 
0 
0 
1 
J 
7 
1 


sa 4 MOOOO 
Pt ri Yi > 
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TABLE 2.1.6-2 
1/0 PORT TRUTH TABLE 


NOTE 

Disabling noise and tone does not turn off a channel. Turning a 
channel off can only be accomplished by writing all zeroes into the 
corresponding Amplitude Control register, R8, R9 or RIO (refer to 
Paragraph 2.1.6.4). 

2.1.6.4 Amplitude Control (Registers R8, R9, R10) 

The amplitudes of the signals generated by each of the three D/A 

Converters (one each for Channels A, B, and C) is determined by 


the contents of the lower 5 bits (B4-B0) of Registers R8, R9 and 
R10 as illustrated by Figure 2.1.6-5. 


FIGURE 2.1.6-5 
D/A CONVERTER SIGNAL GENERATION 
AMPLITUDE CONTROL 


REGISTER # CHANNEL 
R8 A 
RO B 
R10 C 
\ | (| | 
NOT 


sD fo CO) 


Amp] i tude 4-Bit Fixed 
"Mode' Amplitude Level 
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2.1.6.4 (continued) 


The amplitude 'mode' (Bit M) selects either fixed level amplitude (M=0) 
or variable level amplitude (M=1). It follows then that Bits L3-LO 
defining the value of a 'fixed' level amplitude, are only active when 
M=0. When fixed level amplitude is selected, it is 'fixed' only in the 
sense that the amplitude level is under the direct control of the 
system processor (via bits L3-L0). Varying the amplitude when in this 
'fixed' amplitude mode requires in each instance the direct 
intervention of the system processor via an address latch/write data 
sequence to modify the L3-L0O data. 


When M=1 (select ‘variable’ level amplitudes), the amplitude of each 
channel jis determined by the envelope pattern as defined by the 
Envelope Generator's 4-bit output E3-E0 (refer to Paragraph 2.1.6.5). 


The amplitude 'mode' (Bit M) can be thought of as an ‘envelope enable’ 
bit, i.e. when M=0 the envelope is not used, and when M=1 the envelope 
is enabled. 


Figure 2.1.6-6 illustrates all combination of the 5-bit Amplitude 
Control. 


FIGURE 2.1.6-6 
AMPLITUDE CONTROL REGISTERS 
AMPLITUDE CONTROL 


REGISTER # CHANNEL 
R9 B 
R10 C 

\ | | | | | Amplitude Control 
NOT USED M L3 L2 LI LO Output 

0 0 0 0 0 * OO O O The amplitude 
0 ‘ F ‘ ‘ : F . is fixed at 1 of 
0 - : ‘ P 7 ‘ . - 16 levels as 
0 . . . . . . determined by 
0 e ° ° e e ry e e L3-LO. 
0 1 71 74 : ee ee | 
1 X xX X xX F3 E2 ET £0 The amplitude is 


variable at 16. 
(X=Don't Care) levels as deter- 
mined by the 
output of the 
Envelope Gen. 


*The all zeros code is used to turn a channel "off". 
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2.1.6.4 (continued) 


Figure 2.1.6-7 graphically illustrates a selection of variable level 
(envelope-controlled) amplitude where the 16 levels directly reflect 
the output of the Envelope Generator. A fixed level amplitude would 
correspond to only one of the levels shown, with the level directly 
determined by the decimal equivalent of Bits L3-L0. 


FIGURE 2.1.6-7 
VARIABLE AMPLITUDE CONTROL (M=1) 


ke 5 
GRAPHIC REPRESENTATION OF — CHANNEL AT 
THE DECIMAL VALUES OF THE = MAXIMUM 
AMPLITUDE CONTROL OUTPUT AMPLITUDE 


o> CHANNE! 


a paar eee gerne 
(1M) (V4) 


2.1.6.5 Envelope Generator Control (Registers R11, R12, R13) 


To accomplish the generation of fairly complex envelope patterns, 
two independent methods of control are provided in the PSG; 
first, it is possible to vary the frequency of the envelope using 
registers RI] and R12; and second, the relative shape and cycle 
pattern of the envelope can be varied using register R13. The 
following paragraphs explain the details of the envelope control 
functions, describing first the envelope period control and then 
the envelope shape/cycle control. 


2.1.6.5.1 Envelope Period Control (Registers R11, R12) 


The frequency of the envelope is obtained in the PSG by first 
counting down the input clock by 256, then by further counting 
down the result by the programmed 16-bit Envelope Period value. 
This 16-bit value jis obtained in the PSG by combining the 
contents of the Envelope Coarse and Fine Tune registers, as 
illustrated by Figure 2.1.6-8. 
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FIGURE 2.1.6-8 


16-BIT ENVELOPE PERIOD (EP) TO 
ENVELOPE GENERATOR 


ENVELOPE ENVELOPE 
COARSE TUNE FINE TUNE 
REGISTER R12 REGISTER R11 


eA bs 


Note that the 16-bit value programmed in the combined Coarse and 
Fine Tune registers is a period value - the higher the value in 
the registers, the lower the resultant envelope frequency. 


Note also that, as with the Tone Period, the lowest period value 
is 000000000000001 (divide by 1); the highest perTod value is 
11771117791111111 (divide by 65,535 ). 

2 10 


The envelope frequency equations are: 


(a) fE = fCLOCK (b) EP = 256 CT + FT 
“256 EP 10 10 10 
10 
Where: fE = Desired envelope frequency 

fCLOCK= Input clock frequency 

EP = Decimal equivalent of the Envelope 
10 Period bits EP15-EP0 

CT = Decimal equivalent of the Coarse 
10 Tune register bits B7-B0 (EP15-EP8) 

FT = Decimal equivalent of the Fine 
10 Tune register bits B7-BO (EP7-EPO) 


From the above equation it can be seen that the envelope frequency can 
range from a low of fCLOCK/16,766,960 (wherein EP = 65,535 )} 
10 10 


10 
to a high of fCLOCK/256 (wherein EP =1). Using a 1.76475 MHz clock, 
10 10 


for example, would produce a range of envelope frequencies from 0.105 
Hz to 6893.6 Hz. 
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To calculate the values for the contents of the Envelope Period Coarse 
and Fine Tune registers, given the input clock and the desired envelope 
frequencies, we rearrange the above equations, yielding: 


(a) EP = fCLOCK (b) CT + FT EP 
10 2oOTE 10 10 = 10 

Example: 

fE = 0.5 Hz 

fCLOCK = 1.76475 MHz 

6 
EP = 1.76475 x 10 = 13787 
10 i 


Substituting this result into equation (b): 


CT +fFT = 13787 = §3 + 219 
10 10 256 “256 
“256 
CT = 53 = 00110101 (B7-BO) 
10 2 
FT = 219 = 11011011 (B7-BO) 
10 2 


2.1.6.5.2 Envelope Shape/Cycle Control (Register R13) 


The Envelope Generator further counts down the envelope frequency 
by 16, producing a 16-state per cycle envelope pattern as defined 
by its 4-bit counter output, E3-E0. The particular shape and 
cycle pattern of any desired envelope is accomplished by 
controlling the count pattern (count up/count down) of the 4-bit 
counter and by defining a single-cycle or repeat-cycle pattern. 
This envelope shape/cycle control is contained in the lower 4 
bits (B3-BO) of register R13. Each of these 4 bits controls a 
function in the envelope generator, as illustrated in Figure 
2.1.6-9, 
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FIGURE 2.1.6-9 
ENVELOPE SHAPE/CYCLE CONTROL REGISTER (R13) 


B/ B6 B5 B4] B3 B2 BI BO Function 
\not USED ee > HOLD 
dhevsaatins > ALTERNATE To 
Envelope 
See scsoeSNSee > ATTACK Generator 


PR ae ae ET > CONTINUE 


The definition of each function is as follows: 


HOLD 


ALTERNATE 


ATTACK 


CONTINUE 


When set to logic "1", limits the envelope to one cycle, holding 
the last count of the envelope counter (E£3-EO = either 0000 or 
1111, depending on whether the envelope counter was in countdown 
or countup mode respectively. 


When set to logic "I", the envelope counter reverses count 
direction (up-down) after each cycle. 


NOTE 


When both the Hold bit and the Alternate 
bit are ones, the envelope counter is reset 
to its initial count before holding. 


When set to logic "I", the envelope counter will count up 
(attack) from E3-EO = 0000 to E3-EO = 1111; when set to logic 
"0", the envelope counter will count down (decay) from 1111 to 
0000. 


When set to logic "1", the cycle pattern will be as defined by 


the Hold bit; when set to logic "0", the envelope generator will 
reset to 0000 after one cycle and hold at that count. 
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To further describe the above functions, numerous charts of the binary 
count sequence of E3-EO could be used, showing each combination of 
Hold, Alternate, Attack and Continue. However, since these outputs are 
used (when selected by the Amplitude Control registers) to amplitude 
modulate the output of the Mixers, a better understanding of their 
effect can be accomplished via a graphic representation of their value 
for each condition selected, as illustrated in Figures 2.1.6-10 and 
2.1.6-11. 


FIGURE 2.1.6-10 
ENVELOPE GENERATOR OUTPUT 


GRAPHIC REPRESENTATION 
OF ENVELOPE CENERATOR 
OUTPUT E3 €2 E1 £0. 


REFER TO Figure 2.1.6-11 
FOR OETAIL 


S 


er EP IS THE ENVELOPE PERIOO 
(OURATION OF ONE CYCLE) 
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FIGURE 2.1.6-11 
DETAIL OF TWO CYCLES OF FIGURE 2.1.6-10 


2.1.6.6 I/0 Port Data Store (Register R14) 


Register R14 functions as an intermediate data storage register 
between the PSG/CPU data bus (DA7-DAO) and the I/0 Port 
(IOA7-I0A0). This port is available for reading the joysticks. 
Using register R14 for the transfer of I/0 data has no effect at 
all on sound generation. 


To output data from the CPU bus to a peripheral device connected 
to I/0 Port A would require the following steps: 


1. Latch address R7 (select Enable register) 

2. Write data to PSG (setting R7, B6=1) 

3. Latch address R14 (select IOA register) 

4. Write data to PSG (data to be output on I/0 Port A) 
T 

f 


o input data from I/0 Port A to the CPU bus would require the 
ollowing: 


1, Latch address R7 (select Enable register) 
2. Write data to PSG (setting R7, B6=0) 

3. Latch address R14 (select IOA register) 
4, Read data from PSG (data from I/0 Port A) 


Note that once loaded with data in the output mode, the data will 
remain on the I/0 port until changed either by loading different data, 
by applying a reset (grounding the Reset pin), or by switching to the 
input mode. 
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Note also that when in the input mode, the contents of register R14 
will follow the signals applied to the I/0 port. However, transfer of 
this data to the CPU bus requires a "read" operation as described above. 


2.1.7 Joystick Port Operation 


The joystick port (Register 14 of the Sound Chip - Section 
2.1.6.6) is read via an IN-instruction directed at port F6H with 
selection of activating data from the left (player 1) or right 
(player 2) determined by Address bits 8 and 9 as shown in Figure 
2.1.7-1. In order to address Register 14, a OEH must be written 
to port F5H (Sound Generator Address) prior to reading joystick 
data. Section 4.4 describes the software sequence necessary to 
control this hardware. 


In the example of Figure 2.1.7-1, the joystick, shown 
schematically in the lower left of the drawing, is composed of a 
movable center stick which is pushed up to touch the up-contact 
and, therefore, electronically connects pin-8 to pin-1. In this 
state, a read of port F6H with address bit A8 high, causes 
actions as follows: 


(1) Address A8 high turns on transistor Q8 
(2) Q8 drives cable pin-8 low 
(3) The movable center stick of the joystick in contact with 


the up-contact results in a conductive path from cable 
pin-8 to cable pin-1. 

(4) Pin-1 low results in a 0 in bit position 0 of the I/0 
register via the isolation diode. 


The various positions of the stick similarly result in various 
bits being read from the I/0 register. 


Note that +5 volts and ground are available on the connector so 
+5V logic could be attached to the joystick port. 
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FIGURE 2.1.7-1 
JOYSTICK PORT OPERATION 
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2.1.8 Control Logic 


The control logic of the TS2068 is primarily a Standard Cell 
Logic Device in a 68-pin JEDEC leaded carrier package and 
includes the following major functions: 


Attribute Control, and Pixel Data Serial Shift 
Interruption Generation 


SECTION FUNCTION 

2.1.8.1 Bank Selection Logic 

2.1.8.2 Z-80 Clock Generation 

2.1.8.3 Display Timing, DMA Display File Access, 
8.4 


BEEP Output (See Section 2.1.13.2) 
CASSETTE I/0 (See Section 2.1.12). 


Additionally, Table 2.1.8-1 provides a description of the 
function of each SCLD I/0 pin. See the System Schematic in 
Appendix D for pin numbering. 


2.1.8.1 Bank Selection Logic 


The 1TS2068 is a Z-80 based computer, therefore it can 
directly address only 64K bytes of memory via its 16-bit 
address. Additionally, since the Z-80 has no relocation 
or indirection capability, the conventional technique of 
extending the memory space available to the Z-80 is bank 
switching. The TS2068 provides extended bank switching 
by allowing selection of memory in 8K "chunks" which are 
identified by bank number and chunk number as i1]ustrated 
in Figure 2.1.8-1 for the internal bank selection logic. 
The externally sourced BE (Bank Enable) signal can be 
used by external logic to disable the _ internally 
controlled memories. 


As shown in Figure 2.1.8-1: 


(1) The cartridge is selected on a memory access with: 
a. Port FF bit 7 = 0 
b. The HSR at port F4h has a "1" in the bit 
selected by a decode of Address bits 
A13-A15. and 
Cc. BE is high 


causing activation of ROSTS (ROS Chip 
Select). 
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(2) The EXROM bank is selected on a memory access with: 


(3) 


Port FF bit 7 = 1 

The HSR at port F4H has a "1" in the bit 
selected by a decode of Address bits A13 
- Al5. 

BE is high 


caus ity the activation of EXROM (Ext. ROM 
Enable 


The Home Bank is selected on a memory access 


with 


b. 


The HSR at Port F4H has a “O" in the bit 
selected by a decode of Address bits A13 
- Al5. 

BE is high. 


causing the activation of the appropriate 
enable signal as detailed below. 


To understand the details of the schematic of Section 2.2 (Appendix D): 


(1) 


(2) 


(3) 


SELECT CARTRIDGE of Figure 2.1.8-1 involves activating ROSCS to 


its low active state 


SELECT EXROM of Figure 2.1.8-1 involves activating EXROM to its 


low active state 


SELECT HOME BANK of Figure 2.1.8-1 involves 


a. Activating ROMCS to its low active state when Al5=0 and 
b. Recivacin TKS] to its low active state when A1l5=0 and 
ce. Activating TAS2 to its low active state when Al5=1 and 
d. Retivating TKS3 to its low active state when Al5=1 and 
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FIGURE 2.1.8-1 
BANK SELECTION LOGIC 


HORIZONTAL 
SELECT REGISTER 


Port Fah 
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SYMBOL 


AQ-A7 
A13-A15 


DO-D7 


KBO-KB4 


A7R 


MAO-MA7 


TS 


OCPU 


RAST 


TABLE 2.1.8-1 


SCLD 1/0 PIN FUNCTION DEFINITIONS 


NAME 


Address Bus 


Data Bus 


Keyboard Outputs 


A7+Refresh 


Muxed Adrs. Bus 


Tri-State 
Display 
Memory Ctl. 


Clock to CPU 


Read 
Direction 
Control to 
SCLD 


Home ROM 
Chip Select 


Row Address 
Strobe #1 


DIRECTION 


OF SCLD 


In 


Out 


Out 


Out 


Out 


Out 


Out 


Out 
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FUNCTION 


Address Bus lines Input from Z80A 


Data Bus inputs/outputs from/to 
Z80A through U9-74LS245 or inputs 
from display RAM (16K) - U6 and U7 


Inputs from 5 lines of keyboard 
matrix - goes low at one of 8 
address Tine (active low) 
sequences on I/0 Request 


To refresh and address 8th bit 
address line input of RAM memory 
(not display) of 32K of 4416 
RAM's (Home Bank 8000H to FFFFH) 


Display memory muxed address bus 
and refresh 


Tri-State control for address and 
data buffers when CPU is address- 
ing display memory at same time 
display controller is addressing 
the display memory 


CLK - Clock to Z80A CPU which is 
interrupted to stop CPU when CPU 
wants to address display RAM at 
same time as display controller 


To control read/write direction 
of 74LS245 Data Bus Buffer be- 
tween CPU and SCLD 


To activate the 16K Home ROM 
(first 16K) when memory selection 
(MS) is set to Home Bank 


To activate row address strobe for 
display memory only during memory 

read/write, refresh and display 
read 


TABLE 2.1.8-1 
SCLD 1/0 PIN FUNCTION DEFINITIONS 


(continued) 
DIRECTION 
OF SCLD 
SYMBOL NAME IN/OUT FUNCTION 
CAS , Column Address Out To activate column address strobe 
Strobe #1 for display memory only (2nd 16K) 


during memory’ read/write and 
display read 


CAS2 Column Address Out To activate column address strobe 
Strobe #2 for Home Bank RAM (3rd 16K) 
CAS3 Column Address Out To activate column address strobe 
Strobe #3 for Home Bank RAM (4th 16K) 
DRAMWE Dynamic RAM Out When active low, enables a write 
Write Enable into the display RAM only 
MUX Mux Control of Out Mux control to 74LS157 (U10 & U11 
RAM Address to multiplex the row and column 
addresses to all dynamic RAM's 
v Chroma Vector V Out Color vector tevel for quadrature 
(R-Y) input to video modulator 
¥ Luminance Y¥ Out Luminance (brightness) control 
Tevel 
RD Read to CPU In CPU is reading from a memory or 


1/0 location 


WR Write from CPU In CPU is writing to a memory or I/0 
location 
MREQ Memory Request In CPU is requesting access to a 


memory location to read or write 


TORO 1/0 Request In CPU is requesting access to an 
I/0 location to read or write 
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vcc 


ROSTS 


SPKR/TAPE 
OUT 


oc 
BDIR 


BCT 


TABLE 2.1.8-1 
SCLD 1/0 PIN FUNCTION DEFINITIONS 


(continued) 
DIRECTION 
OF SCLD 
NAME FUNCTION 
Refresh In CPU is generating a_ refresh 
address to refresh dynamic RAM's 
Tape Input In Magnetic tape signal input 
Bank Enable In When active low, indicates that 
internal memory is disabled 
(Home, Extension and Dock Banks) 
and an external memory is in use 
Extension Out Active low chip select signal for 
ROM Select Extension ROM 
+5 Volt Power In Power (+5V) input to SCLD 
Interrupt to Out Interrupts CPU to handle keyboard 
CPU strobing and timer for PAUSE com- 
mand. Open drain N channel with 
internal pull-up 
ROS Chip Select Out ROM-Oriented Software (Cartridge 
Bank) Chip Select 
Speaker and Out Digital output to magnetic tape 
Tape Output and to sound amplifier for speaker 
output 
Clock "C" Out Clock for sound chip @1.764 MHz. 
Bus Direction Out A bus direction control signal to 
to Sound Chip the PSG. When high the sound 
chip either receives a write to 
PSG or latches addresses from the 
data bus 
Bus Control to Out A bus control signal to the PSG. 


Sound Chip 


40 


When high the sound chip either 
is read to data bus or latches 
addresses from the data bus 


TABLE 2.1.8-1 
SCLD 1/0 PIN FUNCTION DEFINITIONS 


(continued) 
DIRECTION 
OF SCLD 
SYMBOL NAME IN/OUT FUNCTION 
t scillator Out ut ta scillator amplifier output 
to drive crystal. 
OSC In Oscillator In In Xtal Oscillator amplifier input 
to sense crystal signal 
U Chroma Vector U Out Color vector level for quadrature 
(B-Y) input to video modulator 
GND Ground In Ground return of SCLD 
0 Buffered Clock Out Buffered CPU clock to outside (J1 
- connector) 
R Red Color Output Out Produce color signals to RGB 
monitor (TTL level) 
G Green Color Out Produce color signals to RGB 
Output monitor (TTL level) 
B Blue Color Out Produce color signals to RGB 
Output monitor (TTL level) 
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2.1.8.2 72-80 Clock Generation 


The oscillator circuit utilizes an AT-cut quartz crystal 
at 14.112 MHz. This oscillator feeds a divide by 4 chain 
to generate the 3.528 MHz clock for the CPU (0 CPU). 
This clock runs_ continuously except when the CPU 
addresses the 16K bytes of RAM containing the video 
display file at the same time the video display processor 
‘logic requires access to that same _ RAM, For this 
contention case the CPU clock is stopped in the high 
state until the video display processor access has been 
completed, then the CPU clock continues in its normal 
manner. 


2.1.8.3 Display File H/W Control and Timing 


The 14.112 MHz oscillator is also used to drive the 
counter chain deriving video timing. By dividing the 
14.112 MHz. signal by 896 a 15.75 KHz horizontal sweep 
frequency is generated. The 15.75 KHz signal feeds a 
9-stage counter which counts from 0 to 106H (262 decimal) 
developing the 60.1145 Hz vertical sync. See Figure 
2.1.8-2. 


During each horizontal scan the video display processor 
accesses, in the standard video mode, 32 bytes of pixel 
data plus 32 bytes of attributes by 32 memory accesses 
reading 2 bytes per access in RAM page mode, i.e. the low 
order address bits are provided to the RAM once via RAS 
activation, then the data byte is read during the first 
activation of CAS and the attribute byte is read during 
the second activation of CAS. The page mode operation is 
completed by deactivating RAS. (See Fig. 2.1.8-2.) 


The accessed pixel data is serially shifted out to the 
video generation circuitry at a rate of 1] bit each 142 
nanoseconds (7.056 MHz) resulting in the need to fetch a 
new data/attribute pair each 1.134 microseconds during 
the horizontal scan time. The shifted out pixel 
information is used to control the selection of the 3 
paper color (pixel=0) or 3 ink color (pixel=1) bits to be 
gated out as the R, G, and B signals. When FLASH is 
enabled by the attribute byte, the INK and PAPER field 
information is swapped at the 1.879 Hz. flash rate. The 
R, G, and B signals control the D-to-A converter which 
generates the proper U, V, and Y outputs for use by the 
1889 to create composite video. 


The address information provided to the RAM's during RAS 
and CAS times fs as shown in Figure 2.1.8-2. This 
address generation logic explains the non-sequential 
nature of the video display as described in Section 
2.1.10. 
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FIGURE 2.1.8-2 


VIDEO DISPLAY PROCESSOR RAM ADDRESS GENERATION 
(Normal Video Mode) 


DISPLAY PIXEL DATA ADDRESS 
Address Bit: 15 14 13 12 11 W 9 8 7 6 5 4 3 2 #1 


Range= gS 1 &® R Q M L K{]P _O N TIT H G F OD 


4000H- ora 
S7FFH CAS“TA RAS 


DISPLAY ATTRIBUTE ADDRESS 
Address Bit: 15 14 13 12 11 W 9 8 7 6 5 4 3 2 #1 
Range= Bi £ 1 1 Bf R QYP O N IT H GC F_OD 


5800H- Sa 
5AFFH CAS 1B RAS 
VIDEO TIMING COUNTER CHAIN 
MSB LSB Y PIXEL 
LINE LINE (8 Bit Group) COLUMN 
5s kK 0 PO W MW T R 


Divide by 26 a ee Divide by 16 1.764 

Counter Counter Counter MHz 
60.1145 Hz 15.75 KHz (14.112 
Vert. Sync. Horiz. Sweep MHz/8) 
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2.1.8.4 Interruption Generation (17 ms) 


During the vertical blanking interval (once each 15.635 
ms) the SCLD, if enabled by the INTEN bit (Bit 6) of I/0 
Port FFH, activates the INT signal which directly 
connects to the INT input to the Z80. A CPU maskable 
interruption can then occur, as described in Section 
2.1.3.7, if enabled. 


2.1.9 Keyboard 


The keyboard for the TS 2068 has forty-two (42) hard keys 
(typewriter style) with tactile feel utilizing an 
over-dead-center type of rubber spring pad and a carbon pill that 
hits the P.C. board, just under the keyboard, to short-out a pair 
of closely placed precious metal contacts. The read-out matrix 
is an eight by five cross point switching as shown in Figure 
2.1.9-1. 


Each switch closure connects one of the eight high order address 
lines (by going low through a diode) to one of the five input 
lines to the SCLD (KBO through KB4). 


Scanning is by software algorithm as described in Section 4.1.1. 
During the IN .instruction, address hits AO-A7=FEH select the 
Keyboard I/0 port while bits A8-Al5 select the particular 5 keys 
to be sampled during the particular IN instruction execution. 
For example, an IN instruction directed at the keyboard I/0 port 
with address bit A8 low and A9-Al5 high will supply O's on KBO, 
KB1, KB2, KB3, and/or KB4 if the CAP SHIFT, Z, X, C, and/or V 
keys are respectively devoressed. 


Note that when reading the I/0 port FEH, data bits D5-D7 are not 
part of the keyboard information. 


Section 2.4.7 details the connection of the keyboard to the main 
P.C. board. — 


2.1.10 16K Video Display RAM 


The 16K-byte video display RAM, composed of two 4416's, is 
isolated from the Z80A CPU by the SCLD contro? logic and buffers 
to allow the video display processor to access pixel and 
attribute data from the display files independent of the CPU (see 
Section 2.1.8.3). 


The Video Display RAM is located in Chunks 2 and 3 of the Home 
Bank, beginning at 4000H and 6000H respectively. Figure 2.1.10-1 
illustrates the organization of the Primary Display File located 
at 4000H. The second display fite utilizes the same 
organization. Based on the video mode set via Port FFH, the 
video hardware accesses the RAM for pixel data and attribute 
control information. 
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Figure 2.1.9. KEYBOARD SCHEMATIC 


BOOP baaaae 
pficevietritstae 2) 


enten 


DATA BUS 


DATA BUFFER 
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FIG, 2.1.10-1 
DISPLAY FILE ORGANIZATION (NORMAL MODE) 


32 BYTES 32 BYTES 32 BYTES 
L ; LINE 1 : 


POS. POS. —POS. POS. "POS. POS, 
0/0 o/s) 0/31 7/0 7/1 7/31 


32 BYTES 32 BYTES 
i] 


POS. POS. POS. POS. POS. POS. 


8/0 8/1 8/31 15/0 15/1 15/31 
32 BYTES 32 BYTES 32 BYTES 
1 TINE 17! , 


POS. POS. POS... POS. POS. POS. 
16/0 16/1 16/31 23/0 23/1 23/31 
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2.1.11 


Video 
2.7.11.1 


Generation 
Composite Video 


The U, V, and Y signals from the SCLD are supplied to the 
LM1889 and associated circuitry to produce composite 
video and modulated RF. This circuitry produces color 
vectors at approximately the following angles: 


PHASE TS 2068 NTSC STANDARD 
egrees egrees 
Blue 350 350 
Magenta 64 62 
Red 116 112 
Green 242 240 
Cyan 284 284 
Yellow 170 170 
Reference 224 180 


The Front Porch, Sync Pulse, Back Porch, and Color Burst 
portions of the composite video signal are illustrated in 
Figure 2.1.171-1. In proper adjustment the following 
should be observed: 


40 +/- 2 IRE units 
35 to 45 IRE units 
3.579545 MHz.+/-70 Hz 


Sync Pulse 
Color Burst 
Color Burst Freq. 


The following three facts may aid in understanding 
problems with certain monitors. 


1. The color burst is not synchronous with the 
waveform since it is generated from the 3.579545 
MHz crystal and the waveform is derived from the 
14.112 MHz crystal. The result is observed 
ripples at color boundaries, e.g. green. to 
magenta. 


can The color burst duration jis 8 cycles while 
standard TV broadcast stations provide 9 cycles. 
This "short" burst is a problem for some monitors. 


3. The color burst starts 6.4 microseconds from the 
leading edge of sync. Many monitors are designed 
to expect this start as early as 5.3 
microseconds, thus these monitors may not produce 
color when attached to the TS 2068. 
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FIGURE 2.1.11-1 
COMPOSITE VIDEO SIGNALS 


IRE 


DETAIL 


2.1.11.2 RF Modulator 


The composite video information is used to AM 
modulate the selected channel frequency via the 
LM1889 and associated Channel 2/3 tank 
circuitry. The modulated output is filtered 
through the output filter network to reduce 
harmonic generation to comply with FCC 
requirements. The RF circuitry is physically 
contained inside the RF-can at the rear left 
corner of the PCB (at the RF output jack). 75 
ohms is the output impedance. 
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2.1.12 Cassette I/0 
See Sections 2.1.13.2, 2.4.3 and 4.2. 

2.1.13 Port Map 
Table 2.1.13-1 summarizes the I/0 addressing of ports utilized by 
the TS 2068. Details of the data bits of each of these ports is 
provided by the following sections. 
2.1.13.1 Display Enhancement Control (Port FFH) 


The display enhancement control register within the SCLD 


controls: 

a) Selection of Enhanced Video Modes 

b) Ink selection for 64-Column Mode 

c) Enable/Inhibit the 17 ms interruption to the Z80 
d) Selection of Extension ROM or Cartridge (see 


Section 2.1.8.1) 


-_ OF Ne ead 
64-Column Mode Video Mode 
Ink/Paper Selection Selection 


000 - Black/White 000 - Normal (Primary 

001 - Blue/Yellow Display File) 

010 - Red/Cyan 001 - Second Display File 
O11 - Magenta/Green 010 - High Res. Graphics 
100 - Green/Magenta 110 - 64-Column Mode 

101 - Cyan/Red 

110 - Yellow/Blue Other combinations may 
111 - White/Black produce unpredictable 
results. 


Inhibit 17 ms Interruption 
(0 to Enable) 


EXROM/Cartridge Select 
(See 2.1.8.1) 
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Register 


TABLE 2.1.13-1 


2.1.13.2 Keyboard/Tape I/0 (Port FEH) 


1/0 PORT MAP 
PORT 
ADDRESS 
FUNCTION OPERATION REFERENCE 
Display Enhancement FF 255 «11711771 R/W 2.1.10, 2.1.13.1, 
Control 3.2.2.3, 5.2 
Keyboard/Tape I/0 FE 254 ~=11111110 R/W 2.1.9, 2.1.13.2, 
2.4.3, 4.1.1, 4.2 
Reserved FD 253.—-11311101 
Reserved FC 252 ~=—-11111100 
TS 2040 Printer FB 25) ~=—-11111011 R/W 2,1.13.3, 4.1.3 
Sound Chip & 
Joystick Data F6 246 ~=11110110 R/W 2.1.6, 2.1.7, 2.1. 
2.4.4, 4.3, 4.5 
Sound Chip Address F5 245 =11110101 W Same 
Horizontal Select F4 244 =11110100 R/W 2.1.8.1 


_ Port FEH is used to input Keyboard and Tape data and to 
output Border color, Tape data, and Sound (BEEP) tones. 


READ (IN) 


OO 
KEYBOARD INPUT DATA 
(See 2.1.9) 


Not Used (Set to 0) 
TAPE INPUT (See 4.2) 
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WRITE (OUT) 


BORDER COLOR - 000 Black 
001 Blue 
010 Red 
017 Magenta 
100 Green 
a 101 Cyan 
TAPE 110 Yellow 
OUTPUT 1117 White 
(See 4.2) 


SOUND (BEEP) 
OUT . 


NOT USED 


2.1.13.3 TS 2040 Printer (Port 1XXXXOXX) 


The TS 2040 Printer peripheral is written to and status 
read from via OUT and IN instructions with Bit 7 = 1 and 
Bit 2 = 0 (other bits are not decoded by the printer). 


READ (IN) 


NOT USED Ready for Next 
Pixel | 
Printer Not 


Configured 


Start of 
Paper 


WRITE (OUT) 


Select - 0 = Fast 
he 


Motor ON/OFF 
0 = ON 
1 = OFF 
Pixel to 
Print - 0 = None 
1 = Black 
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2.1.13.4 Sound Chip & Joystick (Ports F5H and F6H) | 


-Ports F5H and F6H are used to control and access the 


Sound Generator and the Joysticks. Details of the 
registers available via these ports jis contained in 
Sections 2.1.6 and 2.1.7. 


2.1.13.5 Horizontal Select Register (Port F4H) 


The HSR addressed via Port F4H jis used in the control of 
the Bank Switching logic as detailed in Section 2.1.8. 
Each bit, when set, enables the corresponding 8K memory 
“chunk” in either the Dock Bank (Port FF, Bit 7=0) or the 
Extension ROM Bank (Port FF, Bit 7=1). The HSR must be 
set to all zeroes in order to enable the entire Home Bank. 


2.2 Schematic Diagram 


2.3 


2.4 


Appendix D contains a detailed schematic diagram of the TS 2068. 


Unit Absolute Ratings 


FUNCTION DESCRIPTION MIN MAX 
TS Storage Temperature -400C +659C 
VAC AC Line Voltage 105V 130V 
Ta Operating Ambient Temp 0°C 40°C 
Vin Voltage on any Logic -0.3V +5.3V 
Pin 
Vin (EAR) EAR input Peak AC ~-2.0V +5,0V 
Vde (IN) Input DC Voltage 14.75V-26V 


Interfaces and Connectors 


The TS2068 has a number of specialized interfaces that are 
accessible via the following connectors: 


CONNECTOR . TYPE ' LOCATION 
System Bus 2X32 Card Edge Right Rear 
Cartridge 2X18 Card Edge Under TCC door 
MIC 1/8" Mini Phone Rear 


EAR 1/8" Mini Phone Rear 

Player 1 Joystick 9-pin "D" Left Side 
Player 2 Joystick 9-pin “D" Right Side 
Monitor RCA Phono Rear 

TY RCA Phono Rear 

Keyboard 14-pin SIP Inside-Left Rear 
AC Adapter : Rear 
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2.4.1 System Bus Connector - P1 
The TS2068 provides a 2 X 32 pin connector, which is 
designated as Pl, at the right rear corner of the 
console. The mechanical, functional, and electrical 
requirements of the system buss connector are detailed in 
the following tables and figures: 
FIGURE /TABLE TITLE 


Figure 2.4.1-1 Pl Mating Connector Mechanical 
Requirements 


Figure 2.4.1-2 Pl Signal Layout 
Table 2.4.1 - 1 P1l Signal Definition 


Table 2.4.1 - 2 Pl Signal Electrical 
Characteristics 


FIGURE 2.4.1-1 
P1 MATING CONNECTOR MECHANICAL REQUIREMENTS 


64 PIN CONNECTOR 


e, MOLDED IN KEY | 7 


FE 


SCALE: NONE 
4 ‘I 
Ha 
| xi 
Eg ‘eae 


Section X-x 
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SPECIFICATIONS: 


0.62520.127 (.3782.005) 
13.07 20.284 (.850 $.010) 


31 EQUAL SPACES AT 
2.64 (.100)=78.74(3.100) 
0.38220.508 (.3302.020) 
FOR 1.875 (.062) BOARD 


SAN dimensions ate in mittimeters, 
dimeacions shown (XX.X) are in inches. 


NOTES: 
. INSULATOR MATERIAL: Ineuletor body shall be 30% 


sless-filled palyester and shall meet ULS4V-0 requirements. 


- CONTACT MATERIAL: Contact material shall be phosphor bronze. 
. CONTACT FINISH: Contacts shall be selectively plated with gold, 


0.900036 (.000015) thick over nickel en contact surfaces. 


« INSERTION FORCE: Iineertion forces shall be 170.1-283.5 grams 


(6-10 oz) per contact pair using a 1.875 (.062) flat steel test blade 


. WITHDRAWAL FORCE: Withdrawal forces shalt be 226.8-340.2 grams 


(8-12 oz) per contact pair using & 1.675 (.062) flat teat blade. 


. NORMAL FORCE: Normal force shall be 65.05 grams (3 oz) minimum 


when mated with a 1.37 (.054) thick test board. 


. PURCHASE FROM: San Diego Microtronics INC. San Diego,CA 92123. 


P71 CONNECTOR SIGNAL LAYOUT 


NO 


@ 
2 


I 


FIGURE 2.4.1-2 


COMPONENT SIDE 


TS1000 COMPATIBLE 


3 
13 


“Ww 


3% WwW wow 
14 we WY 18 


dele 


N-COMPONENT 


S 
=< 


SIDE 


(VIEW FROM FRONT OF COMPUTER) 


54 


TABLE 2.4.1 - 1 
P1 SIGNAL DEFINITION 


SIGNAL NAME DESCRIPTION 


GND Signal Ground 
GND Signal Ground 
EAR EAR Input 
SPKR/TAPE OUT Speaker/Tape Output 
Refresh Address Bit 7 Buffered 
+15 Volts DC 
Data Bus Bit 7 
+5 Volts 
Daisy In (Not Connected) 


Data Bus Bit 0 

Power Ground 

Data Bus Bit 1 

Power Ground 

Data Bus Bit 2 

CPU Clock (Inverted) 

Data Bus Bit 6 

Address Bus Bit 0 

Data Bus Bit 5 

Address Bus Bit 1 

Data Bus Bit 3 

Address Bus Bit 2 

Data Bus Bit 4 

Address Bus Bit 3 

Interrupt Request (Active Low) 
Address Bus Bit 15, Buffered 
Non-Maskable Int. (Active Low) 
Address Bus Bit 14, Buffered 
CPU HALT Indicator (Active Low) 
Address Bus Bit 13, Buffered 
Memory Request (Active Low) ,Bfrd. 
Address Bus Bit 12 

I/O Request (Active Low), Bfrd. 
Address Bus Bit 11 

Read (Active Low), Buffered 
Address Bus Bit 10 

Write (Active Low), Buffered 
Address Bus Bit 9 

Bus Acknowledge (Active Low) 
Address Bus Bit 8 . 

CPU WAIT (Active Low) 

Address Bus Bit 7 

Bus Request (Active Low) 
Address Bus Bit 6 

CPU Reset (Active Low) 

Address Bus Bit 5 

CPU Ml State (Active Low) 
Address Bus Bit 4 

Refresh (Active Low), Buffered 
Daisy Out (Not Connected) 
Extension ROM Enable (Active Low) 
Color Signal - Red 

ROS Chip Select (Active Low) 
(Dock Bank Enable) 

Color Signal - Green 

Bank Enable (Active Low) 
Color Signal ~ Blue 


Analog Sound Signal Output(0-5V) 
Composite Video Signal Output 
Signal Ground 

Signal Ground 


NOTE: All A Pins are on component side of board 
All B Pins are on non-component (soldering) side of board 
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OUTPUTS FROM TS2068 


TABLE -2.4.1-2 


P1 SIGNAL ELECTRICAL CHARACTERISTICS 


INPUTS TO TS2068 


CAPACITIVE INPUT 
LOADING v(OL) 1(LOAD) v(0H) v(IL) V(TH) 1 IN (MAX) CAPACITIVE 
MAX MAX MAX MIN MAX MIN LOADING 

MNEMONIC (PF) VOLTS (MA) VOLTS VOLTS VOLTS yA MAX (PF) 
A158 30 0.5 1.8 2.4 0.8 2.0 1800 40 
Al4B 30 0.5 1.8 2.4 0.8 2.0 1800 40 
A138 30 0.5 1.8 2.4 0.8 2.0 1800 40 
Al2 30 0.4 1.8 2.4 0.8 2.0 1800 74 
All 30 0.4 1.8 24 0.8 2.0 1800 74 
A10 30 0.4 1.8 24 -0.8 2.0 1800 74 
Ag 30 0.4 1.8 2.4 0.8 2.0 1800 76 
A8 30 0.4 1.8 2.4 0.8 2.0 1800 76 
A7 30 0.4 1.8 2.4 0.8 2.0 1800 72 
A6 30 0.4 1.8 2.4 0.8 2.0 1800 72 
AS 30 0.4 1.8 2.4 0.8 2.0 1800 72 
AA 30 0.5 1.8 2.4 0.8 2.0 1800 72 
A3 30 0.4 1.8 2.4 0.8 2.0 1800 72 
A2 30 0.4 1.8 2.4 0.8 2.0 1800 72 
Al 30 0.4 1.8 2.4 0.8 2.0 1800 72 
AO 30 0.4 1.8 2.4 0.8 2.0 1800 98 
A7RB 30 0.5 0.35 2.7 0.8 2.0 Bene 120 
TOROB 30 0.5 12 2.4 0.8 2.0 20 10 
WRB 30 0.5 12 2.4 0.8 2.0 20 10 
RESHB 30 0.5 12 2.4 0.8 2.0 20 10 
EXROM 30 0.5 12 2.4 eee — Sane eS 
ROSCS 30 0.5 12 2.4 — eas — an 
MREOB 30 0.5 12 2.4 0.8 2.0 20 10 
RDB 30 0.5 12 2.4 0.8 2.0 20 10 
MI 30 0.4 1.8 2.4 0.8 2.0 20 10 
BE ae = aoe ae 0.8 2.0 10 12 
BUSAK 30 0.4 1.8 2.4 ape _ Stee an 
WAIT oe ae wes cue 0.8 2.0 ee 10 
HALT 30 0.4 1.8 2.4 0.8 2.0 gues 10 
NaI - = wee eee 0.8 2.0 eae 10 
INT «eee eI nes eeteeteee shes OPEN COLLECTOR WITH PULL-UP ---------------------------------- 
R 50 0.4 1.8 2.4 ace oe beus ie 
G 50 0.4 1.8 2.4 a ee —- es 
B 50 0.4 1.8 2.4 =e = eae a 
VIDEO> 9 < seeeeecaweees 10:75 hie COAX Seeoee <a enoeiweeredeievansatedeteete ecu. a 
D0 30 0.4 1.8 2.4 0.8 2.0 20 120 
01 30 0.4 1.8 2.4 0.8 2.0 20 120 
b2 30 0.4 1.8 2.4 0.8 2.0 20 120 
D3 30 0.4 1.8 2.4 0.8 2.0 20 120 
D4 30 0.4 1.8 2.4 0.8 2.0 20 120 
DS 30 0.4 1.8 2.4 0.8 2.0 20 120 
D6 30 0.4 1.8 2.4 0.8 2.0 20 120 
D7 30 0.4 1.8 2.4 0.8 2.0 20 120 
SPKP/TAPE OUT 500 0.2 0.04 0.3-0. whe --- ---- = 
EAR 15 0.5 1.6 2.4 +/- 1.3 +/- 5.0 a ES 
SOUND 100 0 see 2.5 -0.3 +5.0 sess ae 
BUSRQ ue Ee “++ —_ 0.8 2.0 ee 10 
RESET sodas Suaaccsanesesedincerensa-ueeoteess 1 pF WITH 220K PULL-UP --------------------------- 
IOAS -- eee --- --- --- --- — “- 
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2.4.1.1 Attachment of an RGB Monitor 


The TS 2068 provides via the Pl rear-edge connector the 
ability to attach an RGB monitor for excellent picture 
clarity and resolution. The TTL-level logic signals 
appear directly on the rear-edge connector of the TS 2068 
-- the necessary synch signals can be derived from the 
simple synch stripper/separator circuit described here. 


The Schematic of Figure 2.4.1-3 shows the required 
connections and electronics. Attachment is via_ the 
64-pin keyed Pl connector. Shielding should not normally 
be required, but ferrite beads are recommended on each 
wire to minimize EMI, TVI, etc. 


Circuit Operation - R1 and the base-emitter junction of 
QT operate as a DC restoration circuit with current 
flowing only when the composite video input signal from 
connector pin B31 is at the synch level. With the charge 
maintained on Cl, Q1 conducts only during the synch pulse 
interval (not during the color burst time). During this 
conduction interval, the composite synch signal appears 
in inverted form on the collector of Q1. The Q2 stage 
simply re-inverts the signal, providing at its collector 
a composite synch signal for the connected monitor. 


To provide a separated Vertical synch pulse, R5 and C3 
filter the output of Q1 to partially eliminate the 
Horizontal synch pulses which are shorter than the 
Vertical synch pulses. The partially filtered inverted 
signal is re-inverted by Q3, then R6 and C4 complete the 
elimination of the Horizontal synch pulses so that a 
separate Vertical synch pulse is supplied for the 
attached monitor. 


Signals R, G, and B from connector pins B27, B28, and B29 
can be supplied directly to the attached monitor. 


FIGURE 2. 4.1-3 Q1, Q3: 2N2907 OR EQUAL 


+svDC Q2: 2N2222 OR EQUAL 
840 


COMPUTER 
COMPOSITE 
VIOEO 

831 


COMPOSITE SYNCH 
i TO MONITOR 


OQ GNO TO MONITOR 


ae SIGNAL GND 


B30 C3 VERTICAL SYNCH 
832 sagt TO MONITOR 
827 Ls 

B28 o-F S_9 Sto monitor 

829 oF 8 
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2.4.2 


Cartridge Connector - J4 


The TS2068 provides a 2 X 18 pin connector (designated J4 
on the schematic) under the door at the front right of 
the console. The table and figures listed below detail 
the mechanical, functional, and electrical requirements 
and limits of the J4 Cartridge Connector. 


FIGURE /TABLE TITLE 

Figure 2.4.2-1 J4 Mating PCB Mechanical 
Requirements 

Figure 2.4.2-2 J4 Signal Layout 

Table 2.4.2-1 J4 Signal Definition 

Table 2.4.2-2 J4 Signal Electrical 
Characteristics 
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J4 


FIGURE 2.4.2-1 
J4 MATING PCB MECHANICAL REQUIREMENTS 


TOP VIEW 
WORKING POSITION 


{feereggeeare / 


| eee fe 2 ch 
* ba - Sr TET al 
Ul Rika Sti Bae TAA TE TT ae Lae | 
5 ee) ul: iLL Ga dab bee | 
TO acai gel 
1352-— i | 
ese ws oates 2 
NOTES: — 2.54 ee 


(1) Circuit Board Material: 

FLGFN C62 

C1/1A2A (94V-0) 

Copper 1 or 2 sides 
(2) Contact Fingers: Min. 10 
millionth MIL-G - 45204 Gold over 
-00005 to .00010 inch low stress 
nickel. 
(3) Contact Fingers 2 and 36 
should be longer than other 
fingers to latch-up when inserted 
with power on. 


FIGURE 2.4.2-2 
J4 SIGNAL LAYOUT 


(View from Front) 


S>ialr lf alirinj|a! alfa a || ofjef[Sirmtoa 
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TABLE 2.4.2-1 
J4 CONNECTOR SIGNAL DEFINITIONS 


SIGNAL NAME DESCRIPTION 

AT 46 Address Bus Bit 
+5 volts DC 
Address Bus Bit 12 
Address Bus Bit 13, Buffered 
Data Bus Bit 0 
Data Bus Bit 7 
Data Bus Bit 1 
Address Bus Bit 0 
Data Bus Bit 2 
Address Bus Sit 1 
Data Bus Bit 6 
Address Bus Bit 2 
Data Bus Bit 5 
Address Bus Bit 3 
Data Bus Bit 3 
Address 8us Bit 15,Buffered 
Data Bus Bit 4 
Memory Request (Active Low) ,Bfrd. 
1/0 Request (Active Low) Buffered 
Refresh Address Bit 7, Buffered 
Read (Active Low), Buffered 
CPU M1 State (Active Low) 
Write (Active Low), Buffered 
Address 8us Bit 8 
Address Bus Bit 7 
Address Bus Bit 9 
Address Bus Bit 6 
Address Bus Bit 10. 
Address Bus Bit 5 
Address Bus Bit 11 
Address Bus Bit 4 
Refresh (Active Low), Buffered 
Bank Enable (Active Low) 
Extension ROM Enable (Active Low) 
ROS Chip Select (Active Low) 

(Dock Bank Enable) 

Ground 
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TABLE 2.4. 2-2 
J4 SIGNAL ELECTRICAL CHARACTERISTICS 


ween ene eneee OUTPUTS FROM TS2068 ---------- ooeeeeeseeenes+- INPUTS TO TS2068 -------- 
CAPACITIVE INPUT 
LOADING v(OL) 1(LOAD) V(OH) I(LOAD)*V(IL) V(IH) I IN (MAX) CAPACITIVE 
MAX MAX MAX MIN MIN MAX MIN LOADING 
MNEMONIC (PF) VOLTS (MA) VOLTS {uA) VOLTS VOLTS ya MAX (PF) 
A15B 30 0.5 1.8 2.4 10 
Al48 30 0.5 1.8 2.4 10 
A138 30 0.5 1.8 2.4 10 
Al2 30 0.4 1.8 2.4 10 
AN 30 0.4 1.8 2.4 10 
ATO 30 0.4 1.8 2.4 10 
AQ 30 0.4 1.8 2.4 10 
AB 30 0.4 1.8 2.4 10 
A7 30 0.4 1.8 2.4 10 
AG 30 0.4 1.8 2.4 10 
AS 30 0.4 1.8 2.4 10 
AA 30 0.4 1.8 2.4 10 
A3 30 0.4 1.8 2.4 10 
A2 30 0.4 1.8 2.4 10 
Al 30 0.4 1.8 2.4 10 
AO 30 0.4 1.8 2.4 19 
A7RB 30 0.5 0.35 2.7 
ROSCS 30 0.4 1.8 2.4 10 
MREQS 30 0.5 1.8 2.4 10 
08 30 0.5 1.8 2.4 10 
TORQ 30 0.5 12 2.4 10 
WRB 30 0.5 12 2.4 10 
RFSHB 30 0.5 12 2.4 10 
EXROM 30 0.5 12 2.4 10 
I 30 0.5 12 2.4 10 
00 30 0.4 1.8 2.4 0.8 2.0 15 120 
01 30 0.4 1.8 2.4 0.8 2.0 15 120 
02 30 0.4 1.8 2.4 0.8 2.0 15 120 
03 30 0.4 1.8 2.4 0.8 2.0 15 120 
04 30 0.4 1.8 2.4 0.8 2.0 15 120 
5 30 0.4 1.8 2.4 0.8 2.0 15 120 
06 30 0.4 1.8 2.4 0.8 2.0 15 120 
07 30 0.4 1.8 2.4 - 0.8 2.0 15 120 
Vec (+5V) -- 5.25 300 4.75 
GND -- -- --- --- 
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2.4.3 


2.4.4 


Cassette 1/0 


The EAR and MIC connectors provided on the rear of the 
TS2068 are 1/8" mini-phone jacks requiring 1/8" 
mini-phone plugs as mating connectors. 


The MIC output is filtered by a low-pass filter with a 
breakpoint of 2.5KHz and provides a signal output of 0.15 
to 0.67 V p-p. 


The EAR input is filtered by a low-pass filter with a 
breakpoint of 23 KHz. Input voltages should be between 
4.0 and 10.0 V p-p. 

Joystick 

The joystick input connectors, one on each side of the 
TS2068 case, are standard 9-pin "D" type connectors for - 
use with 5-switch type joysticks. 

Connector layout and the function of each pin is given in 
Figure 2,4,4-1 and Table 2.4.4-1, respectively. 


FIGURE 2.4.4-1 


JOYSTICK CONNECTOR 


SO: @.2 © 
©: @ @ © 
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TABLE 2.4, 4-1 
| _ JOYSTICK CONNECTOR SIGNAL ASSIGNMENT 
P/N SIGNAL NAME 1/0 PORT BIT FUNCTION 


STICK UP 
STICK DOWN 


STICK LEFT 


STICK RIGHT 


not used 


PUSH BUTTON 
5 VOLT POWER 


ADDRESS BIT 8 OR 9* 
POWER GROUND 


*When Address Bit 3 is high, the READ strobe to the left joystick is 
driven low. When address Bit 9 is high, the READ strobe to the right 
joystick is driven low, 


2.4.5 AC Adapter Power Plug 
The AC Adapter provided with the TS 2068 provides unregulated DC 


to the unit as described in Section 2.1.1 Mechanical details of 
the plug which mates to the TS 2068 are shown below: 


MINI- POWER PLUG mi Te MOLDED STRAIN 
DETAIL 78 RELIEF | | 
=e ee = - 
ae -.280/. 315 


097 DC RETURN (GN bd) 
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2.4.6 


2.4.7 


2.4.8 


Composite Monitor Output 


The MONITOR output.on the rear of the TS2068 provides a 1 
VY p-p (+/- 20%) composi te color video signal output to an 
RCA phono jack which is mated by a standard phono plug 
into a 75 ohm coax cable. See Section 2.1.11.1. 


RF Output 


The TV output on the rear of the TS2068 provides a 
modulated color video signal on VHF Channel 2 or Channel 
3 as selected by the channel select switch on the bottom 
of the unit. Connection to the RCA phono jack output 
should be via a standard phono plug and 75 ohm coax 
cable. See Section 2.1.11.2. 


Channel frequencies provided are 


Channel 2 55,250 +/- 100 KHz 
Channel 3 61,250 +/- 100 KHz 


Output levels are less than 3 milliwatts as limited by 
the Federal Communications Commission. . 


Keyboard Interface - J9 Connector 


Located on the PCB inside the TS 2068 is a 14-pin. 
single-in-line flex cable connector (AMP TRIO-MATE P/N 
1-520315-4 or equivalent). Signals are as listed below: 


PIN SIGNAL 


GND 
KBO 

KBI 

KB2 

KB3 

KB4 
CR6/A11 
CR7/A10 
CR8/A9 
CRO/A12 
10 3 CR10/A13B 
1 CR11/A8 
12 CR12/A14B 
3B CR13/A15B 


OANA AaWNH—O 


Any modi fication to or peplacensnt oF the ekeynoeys supplied must 
consider the followings. 


(1) 
(2) 
(3) 


Contact resistance less than 200 ohms. 
Bounce less than 10 ms. 


Capacitance per ‘line less than 20 pF (0 or 1 key 
depressed); less than 40 pF (more than 1 key depressed). 
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3.0 


SYSTEM SOFTWARE GUIDE 


3.1 


Identifier 


Location 19 (13H) of the Home Bank ROM is used to identify the 
revision level of the System Software. The initial version is 
identified by this location having a value of 255 (FFH). Any 
subsequent versions will decrement this value by 1, @e.9., the 
first revision would be identified by a value of 254 (FEH). This 
identifier should be used to conditionally apply patches or 
execute "work-arounds" identified as necessary with a particular 
version of the System Software. 


ROM Organization and Services 
3.2.1 Home ROM 
3.2.1.1 Fixed Entry Points 
Home 80M Location 0 is the entry to the system 
initialization code upon power-up (Ref. Figure 
1.1-4). Locations 8 through 48 (8H through 


30H) are the Z80 RESTART entry points for the 
following functions: 


RESTART FUNCTION 
8 ERROR - Error exit from BASIC 
(Address on Stack points to\Error 
Number ) 
15 WRCH - Write Character (Code in 


A) to Current Output Channel as 
established by SELECT (Address of 
output routine pointed to by 
System Variable CURCHL). (See 
Section 4.0). 


24 IGN SP - Return in A the current 
significant character in the 
Program Line (Address in System 
Variable CH ADD) skipping over 
spaces and control characters 
except End-of-Line (ODH=ENTER) 
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3.2.1.2 


32 NXT_IS - Like IGN SP but returns 
in A the Next Significant 


Character. 

40 CALCTR - Entry to Calculator 
Routines . 

48 COPYUP - Make room for BC Bytes 


of temporary workspace just 
before address in System Variable 
STKBOT by copying up memory 
between there and the address in 
STKEND, adjusting affected 
pointers. Returns DE=Ist Byte of 
Space; HL=Last. 


Location 56 (38H) is the entry to service the 
hardware generated interruption which occurs 
approximately every 1/60 of a second (16.67 
ms). 780 Int... Mode 1 is used. This 
interruption is used to scan the keyboard (call 
to routine UPD K - see Section 4.1.1). It is 
also used to update the Frame Counter (3 bytes 
pointed to by the System Variable FRAMES) used 
by the RANDOMIZE instruction. 


Location 102 (66H) is the entry point for the 
NMI interruption, but this interruption is not 
used in the 1S2068 design. (See Section 
2.1.3.8 NMI Interruption. )} 


BASIC AROS Support 


BASIC Application Cartridges are supported by 
special code in the Home ROM. A program line 
is copied from the cartridge to a buffer in the 
Home RAM (ARSBUF) and jis then executed from 
there by the BASIC Interpreter. When a READ 
command is executed, the line containing the 
appropriate DATA statement is also copfed from 
the cartridge to the RAM. The cartridge memory 
is enabled only for search and copy operations 
for both program lines and DATA statements, and 
when executing a USR function, otherwise the 
entire Home Bank is enabled while executing in 
the BASIC Interpreter. There is no support for 
User-Defined Functions which insert the 
expanded definition parameters directly into 
the program and then require search of the 
program area to find these parameters whenever 
a function is invoked. 


See Section 5.1, Cartridge Software/Hardware, 
for additional details on BASIC AROS. 
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3.2.2 


3.2.1.3 


Extension 


3.2.2.1 


3.2.2.2 


General 


The balance of the Home ROM contains the BASIC 
Interpreter and standard I/0 routines with the 
exception of the cassette I/0 which is in the 
Extension ROM. The bit map table for the 
standard character set is located at the end of 
the Home ROM from Tocation 15616 to 16383 
(3D00H to 3FFFH). The address of this table 
minus 256 (100H) is contained in the System 
Variable CHARS (=3CO0H). 


The Home ROM routines accessible via_ the 
Function Dispatcher are described in - Table 
3.3.4-2. See Appendix A for the ROM Maps 
giving the ROM addresses of these routines. 


ROM 
Fixed Entry Points 


Extension ROM Location 0 contains code to pass 
control to the initialization code in the Home 
ROM. (Figure 1.1-4). 


Extension ROM Location 56 (38H) is the 
interruption fielder. Control is passed to the 
System RAM code (See Section 3.3.3) to bank 
switch to the Home Bank and call the 
interruption service routines after which the 
state of the machine is restored and control 
returns to the interrupted process. Figure 
3.2.2-1 shows the Extension ROM Interruption 
Fielder code. 


General 


The balance of the Extension ROM contains the 
following major components: 


- Final Phase of System Initialization 
(See Figure 1.1-4) : 


- Cassette tape I/0 (see Section 4.2) 

- Change Video Mode Service 

- OS RAM routines including the Function 
Dispatcher (copied to RAM at System 
Initialization) (see Section 3.3.3) 


- Function Dispatcher Jump Table 
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LOCATION 


0038 
0039 
003A 
0030 
003E 
003F 
0041 
0042 
0045 
0046 


Seay a 


FIGURE 3.2.2-1 


Extension ROM Interruption Fielder 


OBJECT CODE SOURCE CODE COMMENTS 

F5 PUSH AF Save AF 

F3 NI Disable Ints. 

3AC25C LD A,(VIDMOD) Test Vidmod 

A7 AND A 

00 NOP 

2804 JR Z,CHK3 Vidmod=0 

Fl POP AF Restore AF 

C36EFA JP INT7 Chunk 7 if Vidmod not 0 
Fl CHK3 POP AF Restore AF 

C3AE62 JP INT3 Chunk 3 if Vidmod = 0 


Video Mode Change Service 


The routine CHNG VID takes as input a single 
byte in Register A which designates the desired 
video mode as shown in Table 3.2.2-1. All 
non-zero values involve access to the second 
display file located at 6000H-7AFFH. When the 
mode change requires remapping of the RAM (see 
Figure 1.1-3), the necessary relocation (BASIC 
program, machine stack, OS RAM code, UDG area, 
etc.) and modifications (system variables, RAM 
code internal addresses, stack pointer, etc.) 
are done by this service. The desired video 
mode is written to Port OFFH, Bits 0-5, and the 
System Variable VIDMOD (5CC2H) is updated. The 
second display file is cleared to zeros on 
initial access (for Dual Screen Mode and High 
Resolution Graphics Mode, this results in a 
black screen since 9 yields attributes of black 
ink on black paper). If there is not enough 
free memory to do the necessary remapping, 
Error 4, Out of Memory is given. 


Access to this service via the Function 
Dispatcher cannot be made consistently for 
various reasons. An Interface Routine is given 
in Section 3.2.2.4, to be executed from the 
Home RAM, which provides access to the Video 
Mode Change Service as well as other Extension 
ROM routines. 


See Sections 4.1.2 and 5.2 for discussion of 
video screen support software. See Section 6.4 
for details on known problems and corrections 
related to the Video Mode Change Service. 
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TABLE 3.2.2-1 


INPUT TO VIDEO MODE CHANGE SERVICE 


VALUE VIDEO 
INA MODE DESCRIPTION 
0 Normal Primary Display File Only(Close 
2nd Display File if Open) 
128 Dual Two Display Files Available. 
( 80H} Screen Primary Display File Active at 
Screen. 
] Dual Two Display Files Available. 
Screen Second Display File Active at 
Screen 
2 High Resolution Primary Display File contains 
Graphics data for 256X192 pixels. Second 
Display File contains 6144 
Attribute Bytes, each one 
controlling 8X1 pixels. NOTE 1. 
64-Column The two display files are com- 
Tnk Paper bined to provide a 64 column X 
24 line screen. Even columns 
6 Black White are derived from data in the 
Primary Display File and odd 
14 Blue Yellow columns from the 2nd Display 
(OEH) File. 
Bits 3-5 of the mode select the 
ink color which determines the 
22 Red Cyan complementary paper color. 
(16H) The Flash and Bright Attributes 
are fixed at 0; the Border is 
30 Magenta Green fixed at the paper color. 
(1EH) NOTE 1. 
38 Green Magenta 
(26H) 
46 Cyan Red 
(2EH) . 
54 Yellow Blue 
(36H) 
62 White Black 
(3EH) 
NOTE 1: The areas of memory normally used for Attribute Bytes are not 


accessed by the video hardware in this mode. 
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3.2.2.4 


Extension ROM Interface Routine 


The Extension ROM routines W TAPE (Write from 
RAM to Tape), R-TAPE (Read from Tape to RAM) 
(see Section 4.2) and CHNG VID (see Section 
3.2.2.2) may be of interest to the machine code 
programmer. Because of a conflict with the use 
of the IX Register, the tape routines cannot be 
successfully accessed via the Function 
Dispatcher. Because the Change Video Mode 
Service may involve relocating the OS RAM 
routines (including the Function Dispatcher), 
and for other reasons, it also cannot be 
consistently accessed using the Function 
Dispatcher. Figure 3.2.2-2 gives a sample 
routine, to be executed from the Home RAM, 
which can be used to bank switch to the 
Extension ROM and call directly to the desired 
service. Appendix A contains an Extension ROM 
Map giving the addresses of these and other 
routines. 
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0000° 
0003° 
0006° 


0008” 
0008” 
GO0E’ 


09010" 
oo13° 
00146” 


0017” 
o018° 
001a° 
001c° 
OO1F° 
0022° 
00246” 
0026” 
0028° 
Qod2a° 
0023” 


oo2c’ 


0020° 
O02E° 
Oo2F”’ 
0031° 
0033” 
0035° 
Q937° 
003a° 
003C° 
093€° 
GO3F° 


BOOFC 
20068 
sQOEGE 
=5CC2 


21 
cc 


21 


co 


Fi 
FE 
20 
32 
3A 
03 
08 
ca 
03 
FB 
C9 
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F3 
F5 
08 
cs 
03 
O08 
32 
3€ 
03 
Fl 
&9 


OOFC 
0020° 
17 


0068 
0020° 
OF 


OEBE 
0020° 


80 

03 
scc2 
002c° 
F4 

FF 

BF 

FF 


FIGURE 3.2.2-2 


EXTENSION ROM INTERFACE ROUTINE 


ODN OW wh we 


RITTP 


CHGvIod 


to ec ee oe 08 an oe os 


EXIT 


; 
HSSAVE 


’ 
TFRTN 


Lo 
CALE 
JR 


LO 
CALL 
JR 


LO 
PUSA 
CALL 
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Eau OOFCH 
EQu 0068" 
£Qu OEGEH 
EQu 5CC2H 
HL, R_TAPE 
IFRITN 

EXIT 

MHLW TAPE 
IFRTN 

EXIT 


HL e CHNG_VIDO 
AF 
IFRITN 


AF 

804 
NZSEXIT 
CVIOMOO) 2A 
A, CHSSAVE) 
COFSH) 2A 
A, COFFH) 
TAA 
COFFH) ZA 


AF 

A, COFFH) 
T,A : 
COFFH) A 
A, COR SH) 
CHSSAVE) 5A 
Agi 
COFGH),A 
AF 

CHLD 


we we oe we ae 


oe 


EXTENSION ROM INTERFACE ROUTINE 
READ TAPE &CUTINE 

WRITE TAPE ROUTINE 

CHANGE VIDEQ MOOE RCUTINE 
VIDEO MODE SYSTEM VARIABLE 


CALL VEADTO WITH REGISTERS SET 
UP FOR R_TAPE ROUTINE 


ADDRESS TO AL 
ENABLE EXT./EXECUTE &TN 
RESTORE HOME BANK AND RETURN 


CALL WRITTP WITH REGISTERS SET 
UP FOR W_TAPE ROUTINE 


ADDRESS TO RL 


CALL CHGVID WITH DESIRED VIDED 
MOOE IN A 


AOORESS TO mL 
SAVE VIDEO MODE 


COMPENSATE FOR “8UG° IN 
CHNG_VIO RTN.WHICH SETS 
VIOMOQO#0 INSTEAD OF 80 
WHEN @0TH SISPLAY FILES 
ARE OPEN 


TEST VIOEQ MODE 
TEST IF 80 


SET VIOMOO=80H 
GET PREV. WGR.SEL. 
RESTORE ; 
READ PORT FF 

TURN OFF RCM SEL. 


SAVE HOR.SEL. CPORT OFSH) 


MASK INTERRUPTIONS 
PRESERVE REG. A 
EXT.ROM SELECT SIT 
SEL. EXT. ROM 


HORIZONTAL SELECT FOR OGCK/EXT 
SAVE 
SELECT CHUNK O IN EXT.RC™ 


RESTCRE REG. A 
EXECUTE TARGET ROUTINE ANC 
RETURN TO CALLER CF TFRTN 


3.3 RAM Organization and Services 


3.3.1 


3.3.2 


3.3.3 


3.3.4 


System Variables 


RAM beginning at 23552 (5COOH) is dedicated to the BASIC 
System Variables as defined in Appendix D of the TS 2068 
User Manual and in Appendix B of this document. The area 
from the end of the defined variables (STRMNM - 23755 
(5CCB) ) to 24297 (5EE9H) is reserved for expansion of 
the System Variables, but is not used by the Operating 
System in the current TS 2068. 


System Configuration Table 


The area from 24298 (SEEAH) to 24575 (5FFFH) is reserved 
for the System Configuration Table (SYSCON). This table 
is built at system initialization time and is comprised 
of an 8 byte entry for AROS, a 4 byte entry for LROS, 
followed by eleven 24-byte entries for proposed expansion 
banks and an End-of-Table marker. In the original TS 
2068 the actual usage of this table is limited to the 12 
bytes for software cartridge identification (see Section 
5.1 for details of the LROS and AROS Overhead Bytes). 


Machine Stack 


The TS 2068 reserves 512 (200H) bytes of RAM for the 
Machine Stack. The Machine Stack pointer is initialized 
to a value of 6200H (value also in System Variable 
MSTBOT); the pointer is decremented as items are pushed 
onto the stack (the pointer may also be modified directly 
by software). While the area reserved for the stack 
extends to 6000H, there is no actual check made to 
enforce this limit. 


Note that the Machine Stack is located in the same memory 
area as the second display file. The CHNG VID routine 
relocates the stack to the memory area from OF7COH to 
OF8BFH, and modifies the Stack Pointer and MSTBOT 
(OF8COH), as well as other affected system variables, 
when ees the second display file. (See Section 
3.2.2.3. 


OS RAM Routines 


The code for the following Operating System functions is 
copied from the Extension ROM to Chunk 3 of the RAM at 
System initialization time. Since this is in the same 
memory area as the second display file, this code must be 
relocated, along with the machine stack, if the second 
display file is to be used. The CHNG VID routine does 
the re relocation and modifications. (Section 
3.20203. 
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Because this code is not in a fixed location, access to 
the OS RAM routines is conditional on the current video 
mode. The standard technique employed is to test the 
value in the System Variable VIDMOD at location 23746 
(5CC2H). A zero indicates that the second display file 
is not in use and that the OS RAM routines are therefore 
in Chunk 3; any non-zero value indicates that the 
routines are in Chunk 7. 


NOTE: This design implies that Chunks 2, 3 and 7 are 
always enabled in the Home Bank RAM whenever 
the System ROM and/or RAM routines are being 
used, 


The OS RAM routines are contained in Module "Dispatch" 
which is included in Appendix A. 


3.3.4.1 RAM Interruption Handler 
Chunk 3 Entry: 62AEH 
Chunk 7 Entry: FA6EH 


The user must enter with bank status and Z80 
registers intact, with address from point of 
interruption on the stack. 


The RAM interruption handler saves. state, 

including memory selection, enables the Home 
Bank, updates the Frame Counter, calls the 
keyboard scan routine in the Home ROM, restores . 
state, and returns to the interrupted process. 


The RAM Interruption handler is used whenever 
the interruption occurs while the Extension ROM 
is enabled. See Figure 3.2.2-1, Extension ROM 
Interruption Fielder. This same technique can 
be used for interruption processing in another 
bank, e.g. if an LROS wanted to use _ the 
standard system ROM keyboard scanning routines. 


3.3.4.2 RAM Service Routines 
Table 3.3.4-1 lists the RAM service routines 
which are designed to facilitate communication 


between memory banks. Those with Service Codes 
are accessible via the Function Dispatcher. 
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LABEL 


GET WORD 
PUT WORD 
GET STATUS 


GET_CHUNK 


GET_NUMBER 


BANK ENABLE 


GOTO_BANK 


CALL_BANK 


SERVICE CODE 
ecima 


14 


15 


TABLE 3.3.4-1 


OS RAM SERVICE ROUTINES 


LOCATION 
6316 FAD6 
633B FAFB 
6405 FBC5 
644D FCOD 
645E FCTE 
6499 FC59 
6572 FD32 
65D0 FD90 
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DESCRIPTION 


Returns in HL the word from the 
address in -HL in the bank 
specified in B. 


Writes the word in DE to the 
address in HL in the bank 
specified in B. 


Returns current memory selection 
(Horizontal Select byte - Tow 
active) in C for the bank 
specified in 8B. Preserves Bank # 
in B for Home, Ext. or Dock. 


Returns a single byte mask in A 
with all bits 0 except the one 
corresponding to the chunk for 
the address in HL. 


Returns in Reg. A the bank number 
currently controlling the address 
in HL. 


Enables the memory selected 
(Horizontal Select byte - Tow 
active) in the specified bank. 
(Bank # in B; Mem.Sel.in C) 


Transfers control to the 
specified address after enabling 
the memory selected in the 
specified bank. Parameters 
passed on stack by pushing target 
address, then Bank #/Mem.Select 
prior to calling GOTO BANK. 
(Return address is discarded. ). 


Like GOTO BANK except saves 
current hank status, calls target 
address, and restores = status 
prior to returning to user. Two 
additional parameters are passed 
on stack prior to doing call to 
CALL BANK. These are PRM OUT 
(16-bits) following by PRM IN (16 
bits) as described for the 
Function Dispatcher. 


TABLE 3.3.4-1 


OS RAM SERVICE ROUTINES 


DESCRIPTION 


Copies n byte(s) from specified 
source to specified destination 
in either ascending or descending 
order, Source and destination 
can be in the same or different 
banks and can be in_ shadowing 
chunks, but neither source nor 
destination can pass a "chunk" 
(8K) boundary since only the 
chunks containing the starting 
source and destination addresses 
are explicitly enabled. 

stack by 


Parameters passed on 


pushing: 


Source Bank/Dest. Bank 

Source Address 

Dest. Address 

Length 

0/Direction: 
(O=Asscending 
-1=Descending) 


(continued) 
LABEL SERVICE CODE LOCATION 
ecima < : 
XFER_BYTES - 6722 FEE2 
NOTE: See Appendix A for listing of these routines. 


known corrections to the routines. 
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See Section 6.0 for 


i 


3.3.4.3 


PRM_OUT 


Function Dispatcher 
Chunk 3 Entry: 6200H ° 
Chunk 7 Entry: F9COH 


The Function Dispatcher provides a common 
interface to a number of system routines via a 
Service Code and Jump Flag parameter passed on 
the machine stack. Table 3.3.4-2 lists the 
routines in Service Code order. Codes for 
routines that are known to not be successfully 
accessible via the Function Dispatcher have 
heen deleted (marked Reserved). However, there 
is no guarantee that those on the list can be 
accessed without problems. Some ROM routines 
require data in a particular format, e.g. BASIC 
floating point number(s), both standard and 
special integer format, on the Calculator Stack 
which is located between (STKBOT) and (STKEND) 
(see Appendix C of the TS 2068 User Manual). 
An effort has been made to include information 
on register usage and functionality, but some 
of the ROM routines are so tightly tied to the 
BASIC Interpreter that they would require 
analysis which jis beyond the scope of this 
document. These have been flagged with an 
Asterisk, but included in the list for 
documentation purposes only. Most of the 
routines which are directly implementing a 
BASIC command or function have two different 
action sequences based on the INTPT Flag (Bit 7 
of FLAGS) which distinguishes syntax checking 
(Flag=0) from actual execution (Flag=1). 


In order to use the’ Function Dispatcher, first 
set up any memory and stack (both machine 
and/or calculator) locations as if invoking the 
desired service directly. Then push the 
parameter(s) for the Dispatcher on the machine 
stack in the order outlined Delow. Finally, 
set up the registers as if invoking the desired | 
service directly and call the Dispatcher based 
on its current location (Chunk 3 if VIDMOD=0 or 
Chunk 7 if VIDMOD has a non-zero value). 


16 bits - Number of bytes of parameter data 
xeing passed on the stack to the specified 
Service (number of stack "pushes" * 2). Zero 
if no parameters being passed. E.g., to pass 4 
bytes: 
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2. 


3. 


PRM_IN 


SVC_CODE 


LD HL,4 
PUSH HL 


This parameter is passed to the Dispatcher only 
if the Jump Flag (SVC CODE) Bit 15) is not 
set. NOTE: This parameter refers to machine 
stack entries only, not to the Calculator Stack. 


16 bits - Number of bytes of parameter data to 
be passed back from the specified Service 
(number of stack "pushes" * 2). Zero if no 
parameters to be passed back. 


This parameter is passed to the Dispatcher only 
if the Jump Flag (SVC_CODE Bit 15) is not set. 
NOTE: This parameter refers to machine stack 
entries only, not to the Calculator Stack. 


16 bits - Bits 0-14 identify the Service to be 
invoked. Bit 15 (Jump Flag) is set if no 
return is desired (jump to Service rather than 
call). Bit 15 is zero if return is desired. 
E.g, to call K_SCAN using Service Code 136: 


LD HL,136 or LD HL, 88H 
PUSH HL PUSH HL 


Addendum To TS 2068 Function Dispatcher Services: 


On page 84, 


COLOR and HIFLSH (service codes 85 and 86) 


cannot always be accessed through the Function Dis- 


patcher, 


due to resetting of the carry flag by the FD. 


COLOR may be accessed by setting the registers as de- 
scribed in the manual, and then coding CALL #23DE. 
HIFLSH can be accessed similarly by coding CALL #2410. 
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' SERVICE 
- GET_STATUS 


GET_NUMBER 


UPD_K 


PARP 


BEEP 


K_DUMP 


SENDTV 


SETAT 


ATTBYT 


R_ATTS 
CLLHS 
CLS 


DUMPPR 


TABLE 3.3.4-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


SERVICE CODE 


14 
15 


- 16-24 
25 


26 
27 
28 


29 


30 
31 


32 
33 
34 


35 


(OEH) 
(OFH) 


(10-18H) 
(19H) 


(1AH) 
(1BH) 
(1CH) 


(1DH) 
(1EH) 
(1FH) 
(20H) 
(21H) 


(22H) 


(23H) 
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DESCRIPTION 
eserve 


Returns Memory Selection (Low 


Active) in C for Bank # in B 


Returns Bank # in A for Address 


“in HL 


Reserved 


Process Keyboard Input (See 
Section 4.1.1) ¢ 


Generates DE+] Cycles of a Tone 


having the Period 8N+236 to 
8N+246 T-States. HL=N. (See 4.4) 


BEEP Command - processes 


‘parameters on Calculator Stack. 


Exits via PARP. (See 4.4) 


COPY Command. Dumps Primary 
ee File to Printer. (See 
4.1.3 


Char.Output to  Screen/Printer. 
Character Code in A. (See 4.1.2) 


Set Print Position, to value in 
BC. B=Line No. (0-23); C=Column 
No. (0-31) 


Set Attribute Byte for Display 
File Adrs. in HL using ATTR_T, 
MASK_T and P_FLAG. 


Permanent Attribute Info. to 
Temporary Attribute Variables 


Clear Lower Screen (Primary 
Display File) 


Clear Entire Screen(Primary 
Display File) 


Print/Clear Print Buffer. (See 
4.1.3) 


SERVICE 


DESLUG 
kK NEW 
INIT 


INCH 


SELECT 


INSERT 


RESET 


CLOSE 
CLCHAN 
OPEN 


OPCHAN 


TABLE 3.3.4-2 
TS 2068 FUNCTION DISPATCHER SERVICES 


(continued) 


SERVICE CODE 


37 
38 
39 


40 


41 


42 


43 


44 
45 
46 


47 


(25H) 


(26H) 


(27H) 


(28H) 


(29H) 


(2AH) 


(28H) 


(2CH) 


(2DH) 


(2EH) 


(2FH) 
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DESCRIPTION 
end Scan ytes) to Printer. 
Pixel Data Address in HL. Number 
of Seans remaining in B (=1-8). 
(See 4.1.3) 


Remove Number Slugs from Edit 
Line Buffer (Address in HL) ~ -- 


NEW command. See Fig. 1.1-4 . 


Initialize: DE=Maximum RAM 
Address. A=0 for Power-On; = -1 
(FFH) for NEW. (See Fig.1.1-4) 


Input Character to A_ from 
currently Selected Channel. 
Returns NC if no input. 


Select Channel (Stream) - # in 
A. (See 4.1) 


Insert BC Bytes before byte whose 
address is in HL. Copies up atl 
from HL to (STKEND) and updates 


affected system variables. 
Returns BC=0; DE=adrs.of tTast 
byte of inserted space; 


HL=adrs.of byte before first. 


Reset Calculator Stack. Sets 
(STKEND) = (STKBOT) and 
(MEM)=MEMBOT (5C92H). 


CLOSE # Command. Channel # on 
Calculator Stack. 


Close Channel. BC=Value from 
STRMS (Index into CHANS). 


OPEN # Command. Channel # and 
Device Spec. on Calculator Stack 


Open Channel. Device Spec. on 
Calculator Stack. DE=pointer 
into STRMS based on Ch.#. 


(See 4.1 for more info. on OPEN 
and CLOSE) 


SERVICE 


ERASE 
FORMAT 
MOVE 
FLASHA 


FIND _L 


SUBLIN 


TABLE: 3.3.4-2 
TS 2068 FUNCTION DISPATCHER SERVICES 


SERVICE CODE 


49 
50 
5] 
52 


53 


54 (36H) 


(31H) 
(32H) 
(33H) 
(34H) 


(35H) 


(continued) 
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DESCRIPTION 
oman ot Applicable 


ERASE Command (Not Applicable) 
FORMAT Command (Not Applicable) 
MOVE Command (Not Applicable) 


Flash Char.in A to Screen. 
(Calls SENDTV; assumes Lower 
Screen selected. Used to Flash 
Cursor. ) 


Find BASIC Program Line with the 
number n= HL. If Line found, 
returns Z and Address of Line in 
HL, else returns NZ and = HL 
contains either address of line 
with next larger line number or 
points to the Variables area if 
there is no larger line number. 
Requested Line No. returned in BC 
and Address of Preceding Line in 
DE (DE=HL if no preceding line). 


Finds either the D'th statement 
(D=Statement #; E=0) or Ist 
statement whose keyword token 
matches E (D=0), in a_ ine 
pointed to by HL. If the. D'th 
statement is found, returns Z and 
HL and (CH ADD) both point to 1 
byte before statement. (If line 
contains exactly D-1 statements, 
then the next line counts as the 
D'th.). If match on E is found, 
then returns NZ,NC and both HL 
and (CH ADD) point to keyword. D 
is decremented by the number of 
statements looked at (e.g. D= -2 
if two statements). If no match 
on E then returns NZ,C with both 
HL and (CH ADD) pointing to 
End-of-Line byte (ODH). 


SERVICE 


DELREC 


PUT BC 


SYNTAX 


EXCUTE 


FOR 
STOP 


NEXT 
READ 
DATA 
RESTBC 
RAND 


TABLE 3.3.4-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


SERVICE CODE 


56 


57 


58 


59 


60 
61 


62 
63 
64 
65 
66 


(38H) 


(39H) 


( 3AH) 


( 3BH) 


(3CH) 
(3DH) 


( 3EH) 
(3FH 

(40H) 
(41H) 
(42H) 


(continued) 
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DESCRIPTION 
eturns in e Teng of the 
record pointed to by HL. Sets DE 
to HL+BC. The record can be a 
program line, or a_ string or 
numeric variable or array. 


Delete record pointed to by HL 
having length BC from Program or 
Variables memory. Updates 
affected system variables. 


Converts number in BC from binary 
to ASCII and outputs to currently 
selected channel. If BC less 
than 0, outputs a 0. 


Check syntax of command. or 
program line in Edit Line Buffer 
(E LINE). ERR NR= -1 if no 
errors, otherwise contains Error 
Number-1. 


Execute command(s) from Edit Line 
buffer. 


FOR command, * 


STOP command. Does RESTART 8 
with Error No. 9. 


NEXT command. * 

READ command, * 

DATA statement. * 

RESTORE command ~ Line No. in BC 
RANDomize command. Sets seed for 
Random Number Generator based on 
Parameter on Calculator Stack. 
If parameter is non-zero, value 


is loaded to SEED; if zero, value 
in FRAMES is loaded to SEED. 


SERVICE 


JUMP 


FIX UI 


FIXU 


CLEAR 


CLR_BC 


GO_SUB 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


SERVICE CODE 


68 


69 


70 


7) 


72 


73 


(44H) 


(45H) 


(46H) 


(47H) 


(48H) 


(49H) 


(continued) 
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DESCRIPTION 
command. oads values from 
OLDPPC and OSPPC to NEWPPC and 
NSPPC and returns. Inside the 
BASIC Interpreter, this results 
in executing from Line No. in 
NEWPPC, Statement No. in NSPPC. 


Jump to Line - Loads Line Number 
from Calculator Stack to NEWPPC 
and sets NSPPC to 0 and returns. 


Converts Floating Point number on 
Calculator Stack to a single byte 
unsigned binary value in A (uses 
FP2A). Does RESTART 8 for Error 
B if number out of range. 


Converts Floating Point number on 
Calculator Stack to a 2-byte 
unsigned binary value in BC (uses 
FP2BC). Error B if number out of 
range. 


CLEAR command. Processes 
parameter on Calculator Stack to 
value in BC for CLR BC. 


Value in BC is new’ RAMTOP. 
Deletes Variables, clears screen, 
and Calculator Stack, etc. 


GO_SUB command. Inserts a 3-byte 
GO SUB Block into the machine 
stack above the 2 most recent 
entries. The Block consists of 
current Line No. (2 bytes) and 
Statement No. (1 byte) to be used 
when RETURN is executed. Then 
calls JUMP to process GO SUB 
parameter and returns. At return 
to caller, machine stack consists 
of top of stack at point GO SUB 
was called, followed by 3-byte 
entry (Line No. MSB/Line No. 
LSB/Statement No. ). 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 
(continued) 


SERVICE SERVICE CODE DESCRIPTION 

ecks 1f room for + (50H) 
bytes between (STKEND) and 
(RAMTOP). Addition of 80 bytes 
is "left-over" from Spectrum to 
guarantee minimum machine stack 
where the stack was at the top of 
RAM, Error 4 if not enough room. 


RETURN 75 (4BH) RETURN command, Retrieves most 
recent GO SUB Biock from Machine 
Stack (SP+4), loads data to 
NEWPPC and NSPPC and returns. 
Error 7 if MSB Line No.=3EH (End 
of Stack Marker). 


PAUSE 76 (4CH) PAUSE command. Processes 
parameter on Calculator Stack to 
BC then waits BC frames or until 
key is depressed. (Uses HALT 
instruction, sO interruptions 
must be enabled. ) 


BREAK? 77 (40H) Reads BREAK key. Returns NC if it 
is pressed and ON ERROR jis not 
active. 

DEF 78 (4EH) Define Function. * 

K_LPR 79 (4FH) LPRINT - Selects Channel 3 and 


processes items in LPRINT 
statement for output via WRCH. 


K PRIN 80 (50H) PRINT - Selects Channel 2 and 

= processes items in PRINT 
statement for output via WRCH 
(same code used for K_LPR). 


P SEQ 81 (51H) Code used by K_LPR and K_PRIN to 
3 process output data and controls 
in BASIC statement (address in CH 


ADD). 
INPUT 82 (52H) INPUT command. Selects Channel 1 
and processes 1/0 for 


Keyboard/Lower Screen using a 
buffer at (WORKSP) for input. * 
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SERVICE 


NOTKB? 


COLOR 


HIFLSH 


SCRMBL 


PLOT 


PLOTBC 


GET_XY 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


(continued) 


SERVICE CODE 


84 


85 


86 


87 


88 


89 


90 


(54H) 


(55H) 


(56H) 


(57H) 


(58H) 


(59H) 


( 5AH) 


84 


DESCRIPTION 
ode use y to process 
input items and controls in BASIC 
statement (address in CH ADD). 


Returns Z if current channel is 
Keyboard/Lower Screen (device 
specification="K"). 


Adjusts system variables ATTR T, 
MASK T and P FLAG for color code 
in D (0-9). “Enter with C set to 
set Ink or NC set to set Paper. 
Error K if D is invalid. 


Adjusts system variables (ATTR T 
and MASK T) for Flash/Bright code 
in D (0, 1 or 8) else Error K. 
Enter with C for Flash or NC for 
Bright. 


Returns in HL the primary display 
file address for the pixel with 
coordinates in BC  (B=Y;C=X). 
Returns in A the bit no (0-7) 
where 0=lefthand or most 
significant bit. Error B if Y is 
greater than 175. 


PLOT command. Processes X/Y 
parameters on the Calculator 
Stack to BC for plotting of pixel 
via PLOTBC. 


Deals with pixel for coordinates 
in BC (B=Y; C=X). Processes 
using P FLAG for Inverse and Over 
attributes. Updates Attribute 
File and sets COORDS=BC. 


Converts a pair of numbers from 
the Calculator Stack to 2 single 
byte numbers. Top number goes to 
B and second to C. OD=sign of 8B 
and E=sign of C (+1 or -1). Used 
by PLOT and other routines. 


SERVICE 
RCLE 


DRAW 


DRAW _L 


EXPRN 


F_SCRN 


F_ATTR 


RND 


F PI 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


SERVICE CODE 


1 


92 


93 


94 


95 


96 


97 


98 


BH 


(5CH) 


(5DH) 


( 5EH) 


( 5FH) 


(60H) 


(61H( 


(62H) 


(continued) 
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DESCRIPTION 
RCLE command. Calculates 
successive plot positions’ from 
the parameters in the BASIC 
statement. * 


DRAW command, Calculates 
successive plot positions from 
the parameters in the BASIC 
statement. * 


Plots a straight line from 
current position (COORDS) based 
on parameters from Calculator 
Stack (X,Y). * 


Evaluates expression in BASIC 
program line (CH ADD), putting 
value on Calculator Stack. * 


SCREEN$ function. Matches screen 
line/col. position (parameters on 
Calculator Stack } against 
standard ASCII character set. 
Returns BC=0 if no. find. BC=1 
and DE points to Char. Code byte 
if match found. 


ATTR function. Returns attribute 
byte value controlling screen 
pixel position based on 
er aaa on Calculator Stack 
X,Y). 


RND function. Uses value in SEED 
to generate a pseudo-random 
number which is placed on the 
Calculator Stack (Floating Point 
number). 


PI function. Places value of PI 
on Calculator Stack. 


SERVICE 


FIND N 


PSHSTR 


PAEDCB 


LET 


POPSTR 


DIM 


STKUSN 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


(continued) 


SERVICE CODE 


100 (64H) 


101 (65H) 


102 (66H) 


103 (67H) 


104 (68H) 


105 (69H) 


106 (6AH) 
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DESCRIPTION 

unction, cans keyboard 
and puts character code byte in 
(WORKSP) if key detected. In any 
case, pushes Regs. AEDCB onto 
Calculator Stack - BC=0 if no 
input; =1 if char. code stored; 
DE=address of char. code byte. 


Find Variable, Searches 
Variables area for match against 
identifier pointed to by CH ADD. 
Adjusts bit NO of FLAGS (Bit 6) 
for type (l=numeric; O=string). 
Also used to find formal 
parameters for User Defined 
Functions. * 


Push String - Clears bit NO of 
FLAGS and pushes Regs. AEDCB onto 
Calculator Stack adjusting 
(STKNXT) upwards. DE contains 
address of string; BC contains 
length. 


Same code as for PSHSTR but 
preserves state of bit NO of 
FLAGS (Bit 6). 


LET command. Processes existing 
or creates new variables, * 


Pop String - Pops end of 
Calculator Stack (  (STKNXT)-1 
through (STKNXT)-5 ) to Regs. 


BCDEA, adjusting (STKNXT) 
downwards. 
DIM statement. Creates or 


initializes numeric or _ string 
arrays. * 


Stack Unsigned Number - inputs a 
floating point number onto the 
Calculator Stack from a _ series 
of ASCII characters addressed by 
(CH ADD). The first character is 
alréady in Reg. A (either decimal 
point, binary token or digit). 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 
(continued) 


SERVICE SERVICE CODE DESCRIPTION 

-byte unsigned integer in A to 
top of Calculator Stack (binary 
to floating point). Loads O to B 
and A to C, then executes STK BC. 


STK BC 108 (6CH) 2-byte unsigned integer in BC to 
— top of Calculator Stack (binary 
to floating point). 


ININT 109 (6DH) Converts a series of ASCII digits 
pointed to by (CH ADD) into an 
unsigned floating point integer 
on the Calculator Stack. First 
character is in A on entry. 
Terminates when non-digit found. 


FP2BC 110 (6EH) Pops top of Calculator Stack 
(floating point number) and puts 
in BC, rounded to nearest 
integer. Returns NZ if value is 
negative. Returns C if number 
exceeded maximum 2-byte value 
(65535). Range: -65535 ~—s to 
+65535. 


FP2A 111 (6FH) Pops top of Calculator Stack 
(floating point number) and puts 
in A, rounded to nearest 
integer. Returns NZ if value is 
negative. Returns C if number 
exceeded maximum 1-byte value 
(255). Range: -255 to +255. 


OUTPUT 112 (70H) Outputs number on top of 
Calculator Stack to currently 
selected channel via WRCH, 
(Converts from floating point to 
ASCII. ) 


Full explanation of the following Calculator Routines is beyond the 
scope of this document. 


SUB 113 (71H) Subtract floating point format 
numbers (HL) minus (DE). (DE) 
assumed to be (HL) + 5, 
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TABLE 3.3.3-2 
TS 2068 FUNCTION DISPATCHER SERVICES 


(continued) 
SERVICE SERVICE CODE DESCRIPTION 

ADD 114 = (72H) Add (AL) + (DE). See SUB. 

MULT 115 (73H) Integer multiply HL * DE. Returns 
C if overflow. 

TIMES 116 (74H) Floating Point Multiply (HL) * 
(DE). 

DIVIDE 117 (75H) Floating Point Divide (HL)/(NDE). 

TRUNC 118 (76H) Truncates a floating point number 


(HL) towards zero to an integer. 
Assumes (DE) = (HL) + 5. 


FLOAT 119 (77H) Converts number (HL) to floating 
point format. Assumes HL points 
to an integer in 5-byte format. 


INTDIV 120 (78H) Replaces top two numbers. on 
Calculator Stack (X and Y) by X 
Mod Y and the integer quotient 
INT (X/Y). Returns with DE and 
HL = Calc. Stack Pointers. 


INT 121 (79H) Replaces the top of the 
Calculator Stack by its integer 
part. Returns with HL = top of 
Calc. Stack and DE = next free 
space. 


EXP 122 (7AH) Replaces the top of the 
Calculator Stack, X, by EXP(X). 
Returns with DE and = HL = 
Calc.Stack Pointers. 


LN 123 (7BH) Replaces the top of the 
Calculator Stack by its natrual 
logarithm. Returns DE and HL = 
Calc.Stack Pointers. 


ANGLE 124 (7CH) Replaces the top of the 
Calculator Stack (X) by Y where Y 
is greater than or equal to -1 
and less than or equal to +1 and 
the SIN X = SIN (PI/2 * Y). 
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SERVICE 


SIN 
TAN 


ATN 


ASN 


ACS 


ROOT 


TO_THE 


RDCH 


SENDCH 


WRCH 
K_SCAN 


TABLE 3.3. 3-2 
TS 2068 FUNCTION DISPATCHER SERVICES 


(continued) 

SERVICE CODE DESCRIPTION 
eptaces the top 0 the 
Calculator Stack by its COSINE. 

126 (7EH) Replaces the top of the 
Calculator Stack by its SINE. 

127. (7FH) Replaces the top of the 
Calculator Stack by its TANGENT. 

128 (80H) Replaces the top of the 
Calculator Stack by its inverse 
TANGENT. 

129 (81H) Replaces the top of the 
Calculator Stack by its inverse 
SINE. 

130 (82H) Replaces the top of the 
Calculator Stack by its inverse 
COSINE. 

131 (83H) Replaces the top of the 
Calculator Stack by its Square 
Root. 

132 (84H) Replaces the top two numbers on 
the Calculator Stack (X, Y) by 
X**Y, 

133 (85H) Wait for character from currently 
selected channel (calls INCH). 
Returns character code in A. See 
4.1.1. 

134 (86H) Write character whose code is in 
A to currently selected output 
channel. See 4.1.2. 

135 (87H) See 3.2.1.1, RESTART 16. 

136 (88H) Keyboard Scan. See 4.1.1 
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SERVICE 


PUTMES 


K CLS 
SCRL 


F PNT 


DRAWLN 


PUT_LN 


TABLE 3.3.3-2 


TS 2068 FUNCTION DISPATCHER SERVICES 


SERVICE CODE 


138 


139 


140 


141 


142 


143 


144 


145 


( 8AH) 


(8BH) 


(8CH) 


(8DH) 


(8EH) 


(8FH) 


(90H) 


(91H) 


(continued) 


90 


DESCRIPTION 
Backspace. ets current column 
position back 1 for’ selected 
device. (System Variable updated 
is S_POSN, SPOSNL, or P_POSN for 
Screen, Lower Screen or Printer 
respectively. ) 


Outputs a space to. currently 
selected device. 


End-of-Line. Sets current 
position to start of next line if 
screen, or outputs printer buffer 
if printer, 


Output message to currently 
selected device. DE points to 
base of message table which 
contains variable length ASCII 
coded messages. The first byte 
of the table and the last byte of 
each message must have the most 
significant bit set. Register A 
contains the message number, 
numbered from O upwards. 


CLS command. Executes both CLS 
and CLLHS. 


Scrolls entire screen (primary 
display file) up 1 line. 


POINT function. Processes X,Y 
parameters from Calculator Stack 
to BC. Returns unsigned integer 
value = O or 17 on Calculator 
Stack reflecting state of pixel 
at coordinates X/Y. 


Same as DRAW _L but enter with BC 
register containing coordinates, 
B=Y and C=X. 


Output Line Number as 4 digits, 
right aligned and space filled to 
currently selected output 
channel. HL points to MSB of 
2-byte Line Number. 


4.0 


SYSTEM 1/0 GUIDE 


4.1 


1/0 Channels 


The TS 2068 software architecture supports up to 19 I/0 Channels 
or "Streams", numbered from -3 through 15. Those numbered less 
than 0 are "hidden" or reserved for system use; Channels 0 through 
15 are available for assignment via the OPEN # command which has 
the following format: 


OPEN # n,s 


where n is the Channel number (0-15) and s jis the Device 
Specification, e.g. "K" (keyboard), "S" (screen) or "P" (printer). 


Channels 0 through 3 are initialized at power-on or execution of a 
NEW command to support the standard system devices and character 
1/0 functions as shown in Figure 4.1-1. Channels 4-15 are 
considered "Closed". You can re-assign the standard I/0, e.g. 
OPEN # 2,"P" will direct all PRINT and LIST commands to the 2040 
Printer instead of the screen. You can also assign Channels 4-15 
and then direct I/O by including the Channel number (or a variable 
equated to the channel number) in the I/0 statement, e.g. PRINT # 
n. Support for other than the standard system devices described 
above fis not implemented in the original version of the TS 2068 
and attempts to OPEN Channels or "Streams" using other than the 
standard device specifications ("K", "S" or "P") will result in an 
error message. One possibility for adding BASIC support for new 
devices is to intercept the I/0 error on OPEN and other commands 
such as CAT and FORMAT via ON ERR and interpret the BASIC program 
Tine using your own machine code routines. 


Channel/ Device 
Stream # Specification Command/Function 


-3 ree Keyboard/Lower Screen 
RESERVED -2 ei Main Screen 
-1 ‘RM RAM Write (not used) 


0 "kK" Output to Lower Screen 
1 "K" INPUT command 

2 “So PRINT/LIST commands 

3 "pt LPRINT/LLIST commands 


FIGURE 4,1-1 
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A. 


B. 


STRMS 


CHANS 


The Channel architecture is implemented by a number of tables 
located in hoth ROM and RAM, 


STRMS is a 38 byte table (2 bytes for each of the 19 channels) 
located in the System Variables area beginning at 23568 (5C10H). 
It is initialized at power-on or NEW to the following values: 


LOCATION VALUE 


5C10 0100 (Channel -3) 

5C12 0600 (Channel -2) | (Copied from 
5014 OBO00 (Channel -1) SMINIT in 
5016 0100 (Channel 0) module EDIT 
5C18 0100 (Channel 1) of the Home 
5C1A 0600 (Channel 2) ROM) 

5CIC 1000 (Channel 3) 

5CIE 0000 (Channel 4) 

5034 0000 (Channel 15) 


This table is accessed using ((Ch.# * 2) + 16H) as an index added 
to 5COOH. The 2-byte value in the table is an index into the 
CHANS area of memory which contains the addresses of the I/0 
routines for the selected channel. If the 2-byte value is zero, 
the Channel is closed. The STRMS table is modified via the OPEN # 
and CLOSE # commands. When a Channel jis OPENed, the device 
specification is used to obtain the 2-byte value to be inserted. 
This value is taken from the table STRMINIT in module EDIT of the 
Home ROM. When Channels 0 through 3 are CLOSEed, the values are 
restored to those used at power-on time. All others are cleared 
to zero. 


The CHANS System Variable at 23631 (5C4FH) contains the address of 
a 21-byte table initialized at power-on or execution of a NEW 
command to support "stream" I/0 to the four standard system 
devices ("K", "S", "R" and "P"), Each table entry is 5 bytes long 
and is indexed by the value obtained from the STRMS table added to 
(CHANS)-1. Each entry has the following format: 


Output Routine Address 2 Bytes 
Input Routine Address 2 Bytes 
Device Specification 1 Byte 


This table is copied from CHINIT in module EDIT of the Home ROM. 
The last byte of the table contains an 80H which will immediately 
precede the first line of the BASIC Program (PROG). 


Whenever an I/0 operation is performed, the appropriate Channel is 


"selected", i.e. its number is used as an index into STRMS to 
obtain the offset into the CHANS table. This offset is added to 
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C. 


D. 


ae 


SELTAB 


SPEC T 


CL_TAB 


The 


(CHANS)-1 and the resultant pointer is loaded into the System 
Variable CURCHL for use by the next character I/0 operation 
(WRCH/RDCH). The device specification from CHANS is used to find 
and execute the initilization routine in SELTAB. 


The Select Table is located in the EDIT module of the Home ROM and 
contains offsets to device dependent initialization routines for 
the standard devices "K", "S" and "P", 


The Specification Table is located in the CHANS module of the Home 
ROM and contains offsets to device dependent OPEN routines for the 
standard devices "K", "S" and "P", It is accessed whenever an 
OPEN # is executed. 


The Close Table is located in the CHANS module of the Home 80M and 
contains offsets to device dependent CLOSE routines for the 
standard system devices "K", "S" and “P", It is accessed whenever 
a CLOSE # is executed. 


following sections describe the standard system I/0 devices 


supported via Channel I/0. 


4.1.1 Keyboard 


The low-level routines supporting keyboard input are 
executed every 1/60 of a second out of the Interruption 
Handler (Location 56 (38H)). The controlling routine is 
labelled UPD K. This routine calls K SCAN to determine if 
any key(s) are currently being depressed, controls the 
debouncing and repeat algorithms, calls K BASE to determine 
the Base Code, calls CHCODE to translate the Base Code based 
on Mode (e.g. "K", "G" or "E" Mode), and finally, stores the 
resultant keystroke code in LAST K and sets the flag 
KEYHIT. Figure 4.1.1-1 illustrates the mode control 
variable and associated flags and Figure 4.1.1-2 contains 
flowcharts of the keyboard support routines. 


The character input routine associated with Device Spec. "K" 
is labeled IN K. The entry address is obtained using the 
pointer in CURCHL when Channel 1 has been Selected and the 
Character I/0 Input routines RDCH/INCH are executed. The 
IN K routine tests the KEYHIT flag to detect the presence of 
input from the keyboard. When the KEYHIT flag=1, the 
contents of LAST K are returned to the requestor. 
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FIGURE 4.1.1-1 
TS 2068 MODE CONTROLS 


System Variable Location Description 


Value 
MODE 23617(5C41H) 0 = "K" or "L" Mode 
1 = "“E" Mode 
2= "G" Mode 


23611 (5C3BH) If MODE = 0 then: 


Bit 3 = 0 for "K" Mode 
= 1 for "L" Mode 


FLAGS2 23658( 5C6AH) If in "L" Mode then: 


O CAPS Lock Off 


Bit 3 = 
= 1] CAPS Lock On 


UPDATE KEYBOARD STATE 
(Catied once every 1/60th of @ second) 


LABEL 
KSTATE 


[ADORESS| 
DEBOUNCE CNT O 
REPEAT CNT O 


KSTATE+4 
EBOUNCE CNT 1 
REPEAT CNT 1 
CHARACTER 1 


REPPER 


o 
a 


INITIAL DEBOUNCE 
NT=5 


FIGURE 4,1.1-2 
FLOWCHARTS 
TS 2068 KEYBOARD ROUTINES 
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RESET REPEAT 
DELETION FLAG 


xsi 


One Keystore 
Location te Empty 


LUKS 


No 
Key O=K STATE (SCOO) 


KEY 1=K STATE 4 (SCO4) 


REPEAT 
Cntr 


x=7 


SCO? of SCOS 


E=Keystroke 


BEING HELO 
[OELETE 
? 


OELAY LOOP 
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ZFn--A 
(Position Code) 
FFFF DE 
FEFE»-BC 


A7-0 =FE 

A15-8 =REGS 
“INVERT DATA 
-MASK FOR § 
BITS 


Produces Low Active Data 
Bite For Keys Pressed 
tn Row Addressed 


ed 
Low Active 
Address Bit 


L-1=-L 
(Next Row) 


FE--FD=-FB 


FT o EF 
eats Stitt Scanning 
(nerunn ) ‘a 
Too Many Keys Scan Complete 
NZ Set 
O=CHAR KEY O=16n(24) D=27n(39) D=FF(-1) 
‘ swat OEE (rerunw) (return) (return 
brig D=NEW KEY 
Found < 
Bit E=PREV KEY Symbol Shirt & CAP Shit & No Keys 
One Other Key One Other Key Or One Key 
-Z Set -2 Set -2 Set 
tf D= 18h -0=18h -D=27h -D=FFh 
SET.NZ (SYM Shit) (CAP Shitt) 
-E=X 
ELSE SET z ekey EC KEY ey 


-Z Wf SYM Shift & One Character Or Just One Character 
D-FF Or SYM Shift E-=CHAR Code 
“NZ tt Two CHAR Keys 
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K< 30h Jon K< SAH 
<> 
E er. 


KTAG4 o-HL 


KTAB6>-HL 


<> Yes 


DIGIT 1-8 
NOin G Mode 


A-10h2-A 


AsBOh—A A-20n"-A 

CONVERT TO CONVERT CONVERT TO 
TO SET SYMBOL 

_MBSAICS FG COLOR 


BRIGHT OA 
NBRIGHT 


A-FEn=A 
CONVERT TO 
FLASH OR 
UNFLASH 


AXOR OFH oa 


CONVERT TO 
INVERSE 
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K-BASE: Find BASE Code For Key 


Key Code=SY¥M SHIFT 
¢ ONE CHAR 
or dust One Char 


Key Code -SYM SHIFT 
w/o Char 


C=O(NC) Cc =O(NC) 


GET XLATE BYTE 
ADDRESSED BY HL 


SET CAMRY FLAG 


cs 
A=COOE 


KTAB2=-HL 


AtASho-A 
FETCH XLATE 


VALUE FROM 


CONVERT TO 


(HLG ADA KEYWORD 


RETURN 


Code in A 
ts OK 


At20h——A 
CONVERT TO 
LOWER CASE 


RETUAN 


Others 


4.1.2 Video Screen 


The TS 2068 system software supports I/0 in the primary 
display file only. See Section 2.1.10 for the display 
file organization. The screen, which is 32 columns X 24 
lines, is partitioned into two parts, the main or upper 
screen (22 lines) and the lower screen (2 lines). The 
lower portion of the screen is used for output of system 
messages and to echo input from the keyboard of BASIC 
commands, BASIC program lines, or data. The lower screen 
expands as needed for multi-line input, scrolling the 
entire screen upwards. The variable DF SZ reflects the 
number of lines in the lower screen (default=2). 


Character output to the screen is done using the Channel 
1/0 described in Section 4.1 using device specification 
"K" for the lower screen and "S" for the upper screen. 
Each character is defined by an 8 X 8 group of pixels. 
The 8 bytes needed for each of the 133 characters 
supported by the TS 2068 are located as shown in Figure 
4.1.2-1. Note that by constructing your own pixel data 
and placing (base address-100H) into CHARS, you can 
define your own character set. 


Associated with each character position jis an Attribute 
Byte controlling the background (PAPER) color, the 
foreground (INK) color, the intensity (BRIGHT), and 
whether the position is constant or alternates between 
true and inverse video (FLASH). Two other "attributes", 
OVER and INVERSE, are implemented by software at the time 
the character(s) are placed into the display file. 


FIGURE 4.1.2-1 
TS 2068 STANDARD CHARACTER TABLES 


Character Set No.of Chars. Char.Codes Location 
Standard 96 32-127 Home ROM 
(20-7FH) (3D00-3FFFH) 
(Address-100H 
in CHARS) 
Std.Graphics 16 128-143 Dynamically 
(80-8FH) Generated by 
Software 
User Defined 21 144-164 Home RAM 
Graphics (90-A4H) (Address in 
UDG) 
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The screen output routine, SENDTV, is in Module IO 1 of 
the Home ROM. This routine is used for output to both 
the screen (upper and lower) and the dot matrix printer. 
The following sequence illustrates the major operations 
involved in executing a PRINT "A" statement: 


ie 


Channel 2 is Selected (normal assignment assumed) 


Toads CURCHL with pointer into CHANS area for 
Channel 2 (first 2 bytes are address of Output 
Routine - SENDTV). 


clears printer and lower screen flags 


sets ATTR T to values based on ATTR P (current 
"permanent" attribute values are transferred to 
the system variable used by the screen output 
routine). If the PRINT statement contained 
temporary attribute controls, they would 
override the settings established via Select. 


The character code for "A" (65/41H) is placed 
in Register A and a RESTART 16 (10H) jis 
executed (WRCH). This jumps to SENDCH - in 
module EDIT of the Home ROM which passes 
control to the SENDTV routine based on (CURCHL). 


The registers are loaded from the System 
Variables with the current Row/Column position 
(S POSN) and Display File address (DF CC) for 
the main screen. 7 


The character code is determined to be from the 
standard character set so the registers are 
loaded with the address from CHARS and the 
offset to the pixel pattern for "A" is 
calculated using the character code X 8 (shift 
left 3 places). 


The first pixel row (8X1) from the character 
table is copied to the display file. The 
character table address is incremented by 1 and 
the display file address is incremented by 256 
(100H). The next pixel row (8X1) is copied to 
the display file. This process is repeated 
until the 8 pixel rows have been copied. 
Masking of the data going into the display file 
is done hased on the flags from P FLAG thus 
controlling the OVER and INVERSE attributes. 


The attribute byte controlling the character 


position just written is updated based on the 
value in ATTR_T and other flags. 
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7. The variables S POSN and DF CC are updated to 
reflect the next screen posftion and return is 
made from the WRCH operation. 


In the above sequence, if the print position for the "A" 
had started a new line following the 22 lines of the main 
screen, the SCROLL? prompt would have been outputted to 
the lower screen and, assuming a positive response, the 
upper screen would be scrolled up 1 line, a blank line 
inserted at the bottom of the upper screen, and the "A" 
printed at the start of the new line. 


Graphics I/O using pixel coordinates is supported in the 
primary display file by the PLOT, DRAW and CIRCLE 
commands. The Home ROM module GRAPHS contains the major 
routines which implement these commands. They are 
limited to the 22 lines of the upper screen (256 X 176 
pixels). 


Figure 4.1.2-2 shows the internal representation used to 
designate row (line) and column positions. See Section 
2.1.10 for details on the organization of the Display 
Pixel and Attribute Files. See Section 5.2 for details 
on software support necessary for the advanced video 
modes. 


FIGURE 4.1.2-2 
DISPLAY FILE ROW/COLUMN NOTATION 


BASIC Parameters Internal Representation 


Line/Row 0 24 (18H) 
1 23 (17H) 


UPPER 
SCREEN 


SCREEN 
Column 0 33 (21H) 
] 32 (20H) 


31 
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4.1.3 2040 Dot Matrix Printer 


Character output to the 2040 Printer is handled by the 
same routine used for the screen, SENDTV. When the 
Printer Flag=1, set by initialization for device "P", the 
pixel data is written into the Print Buffer instead of 
into the Display File. There is no Attribute Byte. The 
"attributes" OVER and INVERSE which are software 
controlled can be active. Since the Print Buffer is 
always precleared to zeros, OVER has no effect. INVERSE 
works exactly as it does for the screen, i.e. INK pixels 
are zero and PAPER pixels are 1. ; 


The Print Buffer is located at 23296 (5BOOH) and is 256 
(100H) bytes long, the data needed to print one line of 
32 characters, each character comprised of 8 bytes (8 X 8 
pixels/character). The buffer is cleared to zeros and 
the flag PRLEFT set to zero at power-on time (or 
execution of a NEW command). The PRLEFT flag is set to 1 
whenever pixel data is written to the buffer. This flag 
is used when exit is made from a program to print any 
unprinted data prior to program termination. As_ the 
pixel data for a particular character is entered into the 
buffer, the buffer address is incremented by 32 (20H); 
the sequential data in the buffer therefore represents 8 
complete scan lines of 32 characters. When the Print 
Buffer is full, or upon processing an End-of-Line (ODH), 
or at program termination, the contents of the buffer are 
written to the Printer, the buffer is cleared and the 
PRLEFT Flag is set to zero. 


Printer I/0 is done via Port OFBH, but the Printer 
responds to any I/0 Read/Write with Address Bit 7=1 and 
Address Bit 2=0. Therefore, any Port providing this 
combination, e.g. Ports OFA through OF8 and Ports OF3 
through OFO as well as others, will interface to the 
Printer. See Section 2.1.13.3 for the bit definitions 
for Printer I/0. The pixel data is written to the device 
by the routine PRSCAN in module IO 2 of the Home ROM 
which outputs 1 scan line (32 bytes), one bit at a time 
on each call to the routine. 


There are two controlling routines for output to the 
printer. DUMPPR is called from SENDTV based on buffer 
full or End-of-Line control. This routine will call 
PRSCAN 8 times to output the 256 bytes of the Print 
Buffer (8 scan lines). The other routine is K DUMP which 
implements the COPY command. This routine calls PRSCAN 
176 times to write the contents of the primary display 
file for the main screen to the printer (8 X 22). All of 
the low level print routines are in module I0 2 of the 
Home ROM. ee 
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4.2 Cassette Tape 


Tape I/0 is done via Port OFEH. An I/0 read of Port OFEH pulls 
in the cassette input on Bit 6. An I/O write of Port OFEH Bit 3 
controls the tape output with Bit 3 = 1 genrating a high output 
and Bit 3 = 0 generating a Tow output. — 


Data is written to the tape under software control creating the 
following frequencies and format: 


- Sync Pattern of 4032 cycles at 806.5 Hz. (5 sec.) 


- Header: 17 bytes of data identifying the following data 
block as either Program, Number Array, 
Character Array, or Binary Code and containing 
other control information. 


The header is written as Data, i.e. the Most 
Significant Bit first in each byte, 1 cycle at 
2040 Hz. for a Zero and 1 cycle at 1020 Hz. for 
a One. The first byte is zero identifying the 
header. The final byte is a Checksum 
calculated by XOR of a11 preceding data bytes. 


- Software delay of approximately 835 milliseconds. 
- Sync Pattern of 1612 cycles at 806.5 Hz. (2 secs.) 
- Transition Pattern of 1 cycle at 2400 Hz. 


- Data Block: Written as Data (see above) with first byte 
= -] (FFH) and a final Checksum byte. 


Figure 4.2-1 shows the header formats for the various types of 
data. 


The routines used to actually write and read the tape (W TAPE and 
R_ TAPE) are in the TAPE Module of the Extension ROM (see map in 
Appendix A). They are accessible via the Extension ROM Interface 
Routine listed in Figure 3.2.2-2. The general flow required to 
write a header and data block is: 


1. Call W TAPE with A=0. IX contains the address 
of the header and DE contains the length. 

2. Delay loop approximately 17 second. 

3. Call W TAPE with A=FFH, IX contains the 
address of the data block and DE contains the 
length. 
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The 2 TAPE routine performs either a LOAD (transfers data from 
tape to memory) or VERIFY (compare data from tape against data in 
memory) operation, based on the status at entry: Carry Set for 
Load and No Carry if Verify. As for the Write, A=Block Type (9 
for Header and -1 (FFH) for Data Block). IX contains the memory 
address. 


The tape routines return Carry=1 for successful completion and No 
Carry for error or Break Key detected. Both W TAPE and R TAPE 
exit via the routine W BORD which restores the Border color based 
on bits 3-5 of the system variable BORDC®. If the Break Key is 
detected during this exit routine, a RESTART 8 (ERROR) is 
executed, 


NOTE: The write to Port OFEH in the exit routine restoring the 
Border Color has bit 3 = 0. This creates a final 
transition on the tape following a write overation. This 
transition is necessary in order to successfully Yread 
back the final data bit from some tape recording 
devices. If you are calling the W_TAPE routine so as to 
bypass the normal exit path, you must perform this final 
write to Port OFEH with Bit 3 = O within a similar 
timeframe. 


Addendum to R TAPE routine: Register DE must contain the 
length of the block to be read (DE=17 for the Header, 
and DE=HDLEN for Data). See Fig. 4.2-1 for a definition 
of HDLEN. 
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PROGRAM i estiéi 


NO.ARRAY ss] * 


CHAR. ARRAY 2 oo 


CODE (BINARY) 3 ; 


4.3 Joysticks 


The two joysticks 


FIGURE’ 4. 2 4 


TAPE HEADER FORMATS 


a? HDADD HDVAR 


Up to 10 
ASCII Chars. 


Length of 
Program 

+ Variables 
(E LINE - 
(PROG) 


Length 
Field from 
Data 
Structure 


Length 
Field from 
Data 
Structure 


Length 
Specified 
in SAVE 


* Starting 


Length of Pro- 
gram = Offset 
to Variables) 
(VARS) - (PROG) 


Line No. 

or 8000H 
E.G.: 
Q500=Line 5 
or 0080H if 
no Line No. 


LSB=00 
oe Array ID 


N/A(=0) 


Ser 00 N/A(=0) 


Address N/A (=0) 
Specified 


in SAVE 


are controlled via Register 14 (1/0 Port A) of 


the Programmable Sound Generator Chip (see Sections 2.1.6 and 


2.1.7). 
respectively. 


The 


joysticks are 


Address and data are passed via Ports OF5H and OF6H 
read by first 
Register 14 in the PSG by writing a 14 (OEH) to Port OFSH. 


addressing 
The 


data is then read by executing an IN from Port OF6H, having the 
port address in Z80 Register C and the joystick (player) number 


in Register B (number = 
is assumed to be zero, enabling I/0 Port A for input. 
ever use I/0 Port A for output (R7,B6=1), 


1 or 2). 


Bit 6 prior to any input operation. 
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Note that PSG Register 7, Bit 6 


If you 
you will want to clear 


Sample routine: 


GETJOY LON A,OEH Load A = 14 
OUT A, (OF5H) Address the joystick port 
LD 8,playerno . 
LD C,OFSH Data Port address to C 
IN A,(C) Joystick data to A 
CPL Complement to High Active 
AND 8FH Get significant bits 


The data read is LOW ACTIVE, i.e. all bits = 1 (byte=FFH) when 
the stick is at center and the button is not depressed. Figure 
4,3-1 shows the interpretation of the data byte. 
FIGURE 4.3-1 
JOYSTICK DATA 
Bit 7 6 5 4 3 2 #1 0 


i i i | [ orn. 
| 


' 
| t 
H ‘ 

1 

i 


| STICK LEFT 


STICK DOWN 


L_ stick RIGHT 
NOT USED (Always '1') 
BUTTON DEPRESSED 


4.4 S/W Generated Sound (BEEP) 


The BEEP command produces sound using the speaker by toggling Bit 
4 of 1/0 Port OFEH to generate a signal of a calculated frequency 
and duration based on the command parameters. It uses the 
routine PARP which takes as input two parameters, one defining 
the period of the signal (HL) and the other defining the number 
of cycles to be generated (DE) and outputs DE+] cycles of a tone 
having the period 8N+236 to 8N+246 T-States where (HL) = N. Both 
the BEEP and PARP routines are in the K SCAN module of the Home 
ROM. The PARP routine is also used to generate the keyboard 
"click" and the "raspberry" which can be varied by modifying the 
values in the system variables PIP (23609/5C39H) and RASP (23608 
5C38H). 


4.5 Sound Chip (SOUND) 


The SOUND command writes the first parameter (register number) to 
Port OF5H (address to Programmable Sound Generator) and the 
second parameter (load data) to Port OF6H (data to PSG). The 
program line is scanned for multiple parameter pairs and 
continues writing address/data pairs to the PSG until the end of 
the statement is reached. See Section 2.1.6 for details on the 
hardware of the PSG. 
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5.0 Advanced Concepts 


5.1 


Cartridge Software/Hardware 


5.1.1 


LROS 
An LROS is identified by the following overhead bytes: 


Location Description 
0000 Not Used 
0001 Cartridge Type 
01=LROS 
0002/0003 Starting Address (LSB/MSB) 


Address to be jumped to after 
Operating System initialization is 
complete. Order of bytes is as for a 
JP instruction. 


0004 Memory Chunk Specification. 
Bits 0-7 represent Chunks 0-7 
respectively in the Dock Bank in low 
active format: 


O if in use 
1 if not in use 


NOTE: When writing to the Horizontal 
Select Register (Port F4H), the 
Chunk Specification is High 
Active 


The Memory Chunk Specification is used to enable the 
specified chunks in the Dock Bank prior to jumping to the 
address specified in Location 2 and 3. . Control is 
transferred from the Initialization code in the Extension ROM 
via the GOTO BANK routine in Home Bank RAM Chunk 3, therefore 
Bit 3 of the Memory Chunk Specification must be. set to 1 in 
order for the transfer to be accomplished as designed (Chunk 
3 also contains the Machine Stack). 


CAUTION: If Chunk 3 jis marked for use in the Dock 
Bank, then when the Memory Chunk Spec. is written to 
Port F4H by the Bank Enable code, execution will 
continue from that point in Chunk 3 in the Dock Bank 
with the Stack Pointer addressing ROM. 


An LROS is Z80 machine code and is in complete control of the 


TS 2068 hardware after transfer to the starting address has 
been made. It can directly implement an application, or it 
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can support multiple applications by implementing a language 
other than BASIC. An AROS dependent on such an LROS would 
have to be part of the same cartridge since there is only one 
cartridge connector. 


Interruption Mode 1 has heen set by the TS 2068 and 
interruptions are enabled prior to passing control to the 
LROS starting address, therefore the LROS must contain 
appropriate code at location 56 (38H) to cover the case where 
the interruption occurs after Chunk 0 in the Dock Bank has 
been enabled, but before any action by the. software cartridge 
to disable the interruption has been taken. Once control is 
transferred, the LROS may then disable the standard TS 2068 
interruption by setting bit 6 of Port. FFH, mask the 
interruption by executing a OI instruction, or set a 
different Interruption Mode. It may change the location of 
the Machine Stack. It may also change the memory selection 
by writing to Port OF4H with each bit set to 1 for the 
corresponding chunk to be enabled in the Dock Bank (high 
active format) or 0 to be enabled in the Home Bank. Thus, an 
LROS may contain code in Chunk 3, but it should be enabled 
after the OS RAM code has finished execution. 


Now that your LROS is in the driver's seat, you are on your 
own: Some important points to remember when mapping your 
Dock Bank memory and doing bank switching are: 


1. The Display RAM is in Home Bank Chunk 2 for the primary 
display file and Chunk 3 for the second display file. 
This memory is accessed independently by the video 
hardware. The software only needs to enable it when 
actually reading or writing it. 


2. The Dock Bank and Extension ROM Bank are mutually 
exclusive since they share the Horizontal Select 
Register in Port F4H. You will need a routine in the 
Home Bank RAM to do any switching hetween the two. You 
must also be careful to have the appropriate Home Bank 
Chunks enabled which are referenced by the Extension 
ROM code, e.g. the System Variables in Chunk 2 or 
possibly the bank switching code in Chunk 3. 


3. Some interesting switching routines can be constructed 
by having parallel code in shadowing chunks of memory 
to take advantage of the "instant" switch in execution 
from one bank to another when the memory selection is 
made, E.g., a routine in the Dock Bank ROM in Chunk 6 
could push a Home Sank address on the stack, write to 
Port F4H enabling Chunk 5 and any other desired chunks 
in the Home Bank (by deselecting them in the Dock), and 
have code at the next sequential instruction address in 
Home Bank RAM Chunk 6 to continue the path. A Return 


107 


instruction, for example, would pass control to the 
address on the stack. Code to switch memory back to 
the Nock Bank could be mapped in a similar way. 


If you plan to use any of the System software routines, 
unless you know otherwise it is probably necessary to 
maintain the contents of Home Bank Chunks 2 and 3 
intact (and Chunk 7 if the OS RAM routines have been 
relocated). The system routines rely heavily on the 
System Variables and assume that any pointers in them 
are pointing to the Home Bank. See Section 3.3.4.1 for 
details on using the RAM Interruption Handler and 
Section 6.0 for known corrections when using System S/W. 


If you design an LROS implementing a_ higher-level 
language and want to support an AROS application, you 
must design your own initialization code to detect the 
presence of such an AROS. The TS 2068 will not look 
for the presence of an AROS if an LROS jis present, 
therefore there will be no entry for the AROS in the 
System Configuration Table. Note that since there is 
only one cartridge connector, such an AROS would also 
have to be integrated with the supporting LROS in a 
single cartridge or cartridge board. 
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5.1.2 AROS 


An AROS is identified by the following overhead bytes: 


Location 


32768 
( 8000H } 


32769 
(8001H) 


32770/32771 
(8002/8003H) 


32772 
(8004H) 


32773 
(8005H) 


32774/32775 
( 8006 /8007H) 


Description 


Language Type 
1 = BASIC [and machine code] 
Machine code only 
(Any other value will result 
in Error S, Missing LROS) 


2 


Cartridge Type 
2 = AROS 


Starting Address(LSB/MSB) 
BASIC AROS = Addrs. of First 
Progran Line 


Machine Code AROS = Addrs. of 
First Z80 Instruction 
Memory Chunk Specification 
Bits 0-7 represent Chunks 0-7 
respectively in the Dock Bank 
in low active format as follows: 


0 if in use 
1 if not in use 


NOTE: Bits O-3 must he set to 1 
for proper execution. 


Autostart Specification 
No Autostart 
Autostart 


1 


Number of bytes of RAM to be 

Reserved for Machine Code 

Variables (LSB/MSB - O100H=1 byte 
Reserved; 0002H=512 
bytes Reserved, 


5.1.2.1 BASIC AROS 


A BASIC AROS is supported by special code in the System 
ROM (Section 3.2.1.2). The portion of the cartridge 
containing BASIC program lines is restricted to the 
upper half of the memory space beginning at location 
32776 (8008H) in the Dock Bank. Support for 
User-Defined Functions, which requires searching for 
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the definition parameters within the program, is not 
implemented. Also, because the support code interfaces 
directly to the bank switching code in: Home RAM Chunk 3 
(does not allow for it to be relocated to Chunk 7), a 
BASIC AROS cannot utilize the advanced video modes and 
also execute BASIC program statements. If the 
cartridge contained machine code supporting advanced 
video modes, the TS 2068 would have to.be returned to 
"Normal" video mode with the RAM mapped accordingly 
(see Figure 1.1-3) if control were to be returned to 
the BASIC Interpreter USR code. 


Since execution of the cartridge BASIC program is done 
by copying program lines to a buffer in the Home Bank 
RAM (ARSBUF), the most efficient cartridge execution is 
obtained by making program lines as large as onssible, 
i.e. making use of the multi-statement feature of the 
TS 2068. The reverse is true concerning execution of 
READ commands. An entire DATA statement is copied to 
the Home Bank RAM, but only the current item is 
accessed. It therefore will be more efficient to not 
make DATA statements excessively Jong. The BASIC 
program lines appear in the cartridge in exactly the 
same format used in the RAM, i.e. Line Number (2 
bytes), Length (2 bytes), Command Token, etc. 
terminated by an Enter (ODH). Numerical constants 
appearing in a program line are followed by the CHR$ 
(OEH) byte and 5-byte floating point format described 
in the User Manual (see Appendix C of the TS 2068 User 
Manual). The Variables area is built in the RAM 
(address in VARS) exactly as though the program were in 
the RAM. All variables, including arrays, are Suilt at 
the time of program execution - there is no provision 
for copying or accessing pre-defined variables from the 
cartridge, however, see Section 5.3.2. The last 
program line must be followed by a terminator byte 
having the Most Significant . Bit set (e.g. 80H), 
otherwise the Interpreter cannot detect: the end of the 
program. 


A BASIC AROS may contain machine code accessed via the 
USR function. If the machine code address is within 
the memory designated by. the AROS Memory Select 
Specification as "in use", the Dock Bank will be 
enabled, otherwise the machine code address is assumed 
to be in the Home Bank. (See Section 6.0 for details 
on known problems in this area of the code.) 
Obviously, once control is transferred to the machine 
code in the AROS, the hall is now in your court. You 
could have additional machine code residing in the 
lower half of the Dock Bank memory space which you can 
now switch in. You only have to know what you're 
about. If and when you are ready to go back to 


110 


5.1.2. 


executing your BASIC program, you must enable Chunks 
0-3 in the Home Bank and have the stack and other Home 
Bank RAM in the proper state for return to the USR 
function code in the BASIC Interpreter, i.e. what it 
was when the USR function passed control to you. 


The Autostart feature begins execution out of the BASIC 
AROS immediately after system initialization. If the 
Autostart parameter is zero, control will go to the 
BASIC Interpreter as if there were no _ cartridge 
installed, although internal flags have been set noting 
that a BASIC AROS jis present. The cartridge will be 
started when you execute a RUN or GOTO Line Number 
command, 


The final parameter in the overhead bytes allows you to 
reserve RAM beginning in Chunk 3 at Location 26688 
(6840H) for machine code and/or machine’ code 
variables. The designated number of bytes are reserved 
by the AROS support code prior to beginning program 
execution. The AROS buffer (ARSBUF) begins immediately 
following this reserved area (see Fig. 1.1-3). Note 
that this area is part of the RAM that gets relocated 
if the second display file is opened. Therefore access 
to your machine code and/or variables should be 
conditional on the video mode rather than direct if you 
are going to be using the advanced video ‘modes... This 
reserved area begins at 31488 (7B00H) when the second 
display file is open. Remember -- use of: the second 
display file and execution of BASIC program from the 
cartridge are mutually exclusive. 


The standard technique of reserving space for machine 
code by modifying RAMTOP could also be used to place 
machine code/variables at the top of the’ Home Bank 
RAM. If you place code above (RAMTOP) which is to be 
accessed via the BASIC USR function, the affected 
memory chunk(s) cannot be marked as “in use" in the 
cartridge in the AROS Memory Selection Specification. 


2 Machine Code AROS 


A machine code AROS is similar to an LROS with the 
exception that it is dependent on the System ROM for 
interruption handling if the interruption is enabled. 
This implies that Chunks 0-3 are enabled in the Home 
Bank. 


lil 


The Autostart parameter should be set to 1 since if it 
is zero, control will be passed to the BASIC 
Interpreter as if the cartridge were not present. 

There is no BASIC command to directly. start execution 
of a Machine Code AROS. 


Because of a "bug" in the Initialization code handling 
a Machine Code AROS, the parameter specifying the 
number of bytes to be reserved for machine code 
variables must be adjusted by adding 21 (15H) to the 
actual number of bytes needed. This preserves the 21 
byte CHANS area starting at 26688 (6840H). The 
reserved area then starts at 26709 (6855H) (or 31488 
(7B15H) when the second display file is open). Access 
to the variables should be conditional based on the 
video mode rather than direct if you plan to use the 
advanced video modes. If you do not plan to utilize 
any of the system software, you can disregard the above 
and "do your own thing" with the RAM. 


See Section 6.0 for known corrections when using System 
S/W. 


§.1.3 EPROM Cartridge Board Application 


Figure 5.1-1 provides the logic diagram for a pluggable EPROM 
cartridge board capable of configuring up to four 16K-byte 
(128K-bit) EPROM's of the 27128 type. The artwork for the PC 
board implementing that logic diagram is provided in Figures 
5.1-2, 5.1-3 and 5.1-4 for the Component Side art, the Solder 
Side art, and the Solder Mask (one common mask for both 
sides), respectively. 


See Section 2.4.2 for mechanical details of the connector 
portion of the PCB. 
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FIGURE 5.1-1 
PLUGGABLE EPROM CARTRIDGE BOARD 
LOGIC DIAGRAM 
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FIGURE 5.1-2 
EPROM CARTRIDGE BOARD 
COMPONENT SIDE ARTWORK 
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SK 2000-81 


FIGURE 5.1-3 
EPROM CARTRIDGE BOARD 


SOLDER SIDE ARTWORK 


FIGURE 5.1-4 
EPROM CARTRIDGE BOARD 
SOLDER MASK 
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SOLDER MASK 
SK2000-81 
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5.2 Advanced Video Modes 


The following sections describe the various video modes 
available on the TS 2068 and the major software support 
functions necessary. See Sections 3.2.2.3 and 3.2.2.4 for 
details on using the Video Mode Change Service. Appendix ¢ 
contains descriptions and code listings for a number of 
software packages developed by Timex that support various 
screen modes and applications. Reference to these packages 
should aid in gaining an understanding of the software 
teciniques needed to support the video mode hardware. 


The TS 2068 video mode hardware works out of two areas of 
RAM, the primary display file at 4000H and the second display 
file at 6000H. Each area consists of 6912 (1BOOH) bytes used 
for pixel and/or attribute data based on the mode selected 
via bits 0-5 of Port FFH. The pixel data area divides into 
three blocks, each supporting 8 contiguous lines on the 
screen. See Section 2.1.10 for details on organization of 
the display RAM. Because the two display files occupy the 
same relative positions within their respective 8K Chunks, by 
setting/clearing Address Bit 13 a software routine can 
address the corresponding location in each file: 


Address Bit 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 
DF 


4000 - 5AFFH (Bit 13 = 0) 


Address Bit 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 900 
DF2 


6000 - 7AFFH (Bit 13 = 1) 


In order to display a character on the screen, 8 bytes of 
pixel data must be entered into the display file, one for 
each scan row. For a particular character position, the scan 
rows are JO0H bytes apart. E.g, the 8 bytes of pixel data 
for position Line O/Column O are located at 4000H, 4100H, 
4200H,...... ,4700H. Since this is the first character 
position on the screen, its Attribute byte, in Normal Mode, 
is the first byte in the Attribute File which starts at 
5800H. The 768 (300H) Attribute Bytes are in sequential 
order starting at position 0/0 through 0/31,1/0 through 1/31, 
and so forth, ending with 23/0 through 23/31. 


One method of determining the starting display file address 
for a particular line/column position is to build a table 
containing the starting address of each of the 24 lines (2 
bytes per entry). Then construct an algorithm that takes the 
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LINE # 
> 
1 
2 


Woon 


15 
16 
17 


23 


line number and forms an index by multiplying it by 2 (shift 
left 1), add the index to the base address of the table, and 
read out the display file address. The column position is 
then simply an offset added to this address. 8y testing 
VIDMOD (23746 - 5CC2H) you can determine whether to set Bit 
13 for the second display file, e.g. hecause you are in an 
odd column in 64-column mode, or simply because you are using 
the second display file in dual screen mode, 


The following example illustrates this method. The table 
entries are in Hex: 


TABLE 
INDEX 
0 00 40 4000H = Line 0 (Top of Screen) 
2 20 49 Line 1 
4 40 40 Line 2 
(+20H) 
; (+20H) 
14(0EH) EO 40 Line 7 (End of Upper Block) 
16(10H) 00 48 4800H = Line 8 (Top of Middle Block) 
18(12H) 20 48 Line 9 
‘ (+20H) 
. (+20H) 
30(1EH) EO 48 Line 15(End of Middle Block) 
32( 20H) 00 50 5000H = Line 16(Top of Bottom Block) 
34( 22H) 20 50 Line 17 
: (+20H) 
: (+20H) 
46(2EH)..... EO 50 Line 23(End of Bottom Block) 


Line 17, Column 23 (11H/17H) would yield a display file 
address of 5020H + 17H = 5037H. If VIDMOD indicated the 
second display file was to be used, setting Bit 13 of the 
address would yield 7037H. If we were using 64-column mode, 
because the column is odd (Bit O=1) we would set Bit 13 of 
the starting line address getting 7020H, then divide the 
column address by 2 (shift right 1) since there are only 32 
columns in each display file. This would give us an offset 
of 11 (OBH) which added to the starting address results in a 
display file address of 702BH. Having the display file 
address, we now insert the 8 bytes of pixel data for the 
character desired, incrementing the display file address by 
100H between each write (this is easily done by simply 
incrementing the upper register of the register pair 
containing the address). The following routine jis a 
simplified version illustrating this process. It assumes 
that Reg. Pair DE contains the address of the desired 
character in the character table and that HL contains the 
address of the desired position in the display file. 
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LD B,8 Set Scan Count 


LOOP LD A, (DE) Get pixel pattern 
LD (HL) ,A Write to Display File 
INC DE Next pixel pattern byte 
INC H Next DF Position (+100H) 
DJNZ LOOP Continue for 8 Scan Rows 


Finally, we must update the Attribute Byte controlling the 
updated character position. The following sample algorithm 
will formulate the Attribute File address given the address 
of any of the scan rows of the character position. We will 
assume we have saved off the starting display file address 
and now have it in Register Pair HL. 


GETATT LD A,H MSB of DF Address 
RRCA Shift right circular 
RRCA to get Bits 3&4 (Block #) 
RRCA to positions 0&1 
AND 3 Clear other bits 
OR 58H OR in Attr.File Base Adrs. 
LD H,A Update MSB 


NOTE: The LSB is the same as 
for the pixel data. 


Jsing our first example, with a Display File address of 
5037H, the Attribute File address would be 5A37H. The second 
example was using 64-Column Mode which does not require 
attribute file update (attributes determined by video mode 
setting). 


See Section 5.2.2 for a sample algorithm to formulate the 
display file address for X,Y pixel coordinates. The above 
routine for calculating Attribute File address would be 
substituted for the method used in the example if not working 
in High Resolution Graphics mode. 


In addition to data insertion, two major screen support 
functions are scrolling and clearing the screen. Scrolling 
is done in the System ROM by copying the entire display file 
data and attribute controls up one line position (Line 1 to 
Line 0, Line 2 to Line 1, etc.) and inserting a blank line at 
the bottom. Numerous more elaborate scrolling techniques can 
be implemented using various directions (up, down, left, 
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right) and smaller areas or "windows" of the screen. 
Similarly, clearing the screen, which consists of writing 
zeros to the data file and updating the attribute bytes to a 
uniform value, can be implemented on smaller sections of the 
screen. The software packages in Appendix C contain examples 
of such implementations. 


Dual Screen Mode 


In this mode the second display file is used to provide a 
second independent screen having the same data and attribute 
organization as the primary display file. By writing to Port 
FFH with Bits 0-5 = 1 (3it 0 set), the second display file is 
activated at the video screen. Appendix C contains a 
software package supporting Dual Screen Mode. The software 
package uses the system variable VIDMOD to determine which 
display file is the target of the current operation. Special 
values for VIDMOD have been defined to permit building of one 
display file while the other is active at the screen so that 
a complete screen image is ready when the hardware mode is 
changed. Copy and Exchange routines have been provided to 
move data within and between the two display files. This 
enables the BASIC graphics commands like PLOT, CIRCLE and 
DRAW, which work only in the primary display file, to be used 
to create screens which are then moved into the second 
display file. 


Because the System ROM works only in the primary display 
file, you can come up with some unusual situations when you 
nave the second display file active at the screen and you are 
executing BASIC or using the System ROM routines. If an 
error occurs, for example, the error message will be placed 
into the primary display file and the ROM will be waiting for 
input from the keyboard to direct the next action, but all of 
this is invisible since you have the other display file 
active. The machine will appear to be "hung", but it is only 
doing its normal thing. Be prepared to enter a OUT 255,0 to 
an invisible command line in order to switch the display back 
to the standard file!!! Don't forget to also set VIDMOD 
(POKE 23746,128) to keep things consistent inside the dual 
screen support code. 


High Resolution Graphics Mode 


This mode is set by writing to Port OFFH with Bits 0-5=2 (Bit 
1 set). In this mode, also called Extended Color Mode, the 
second display file is used to expand the number of Attribute 
bytes from one for each 8 X 8 pixel group to one for each 8 X 
1 pixel group thus giving 32 X 192 positions within each of 
which two colors plus Bright and Flash can be defined. Each 
byte of pixel data entered into the primary display file has 
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its own Attribute byte in the corresponding location in the 
second display file, e.g. the byte written to Location 4000H 
has its Attribute byte at Location 6000H, the byte at 47FFH 
(last byte of last scan row in Line 7) has its Attribute byte 
at Location 67FFH, the byte at 57FFH (last byte of last scan 
row in Line 23) has its Attribute byte at Location 77FFH. 
The routine writing data to the screen would therefore enter 
the pixel data to the desired location and then set Address 
Bit 13 of the Primary Display File address and write the 
desired attribute control byte to the resultant location. If 
normal characters are being written to the screen in this 
mode, eight Attribute bytes must also be written, one for 
each of the bytes defining the character. The same technique 
would be used for writing to both display files, i.e. for 
each of the seven bytes entered after the first, the display 
file address would be incremented by 256 (100H). 


The System ROM graphics commands (PLOT, DRAW and CIRCLE) 
place data into the Primary Display File and update the 
Attribute File associated with the standard video mode 
( 5800H-5AFFH). In High Resolution Graphics Mode, the 
hardware does not access this area for attribute control, 
therefore its contents have no visible effect. If before or 
immediately following execution of the BASIC graphics 
operation, you update the attribute control] information in 
the second display file, you could possibly take advantage of 
the System ROM graphics capability. Admittedly, this is not 
a simple operation in the case of circles or drawing diagonal 
lines and it will be more efficient to develop code 
specifically to support this video mode. 


The following sample routine takes as input two single byte 
binary digits representing the X and Y coordinates of a pixel 
position on the screen. It formulates the display file 
address of the byte containing the pixel, creates a pattern 
or mask byte for the specified bit position, sets the bit in 
the display file, and updates the attribute byte (High 
Resolution Graphics Mode assumed). This represents a 
simplified version of the approach used in the System ROM 
graphics support routines PLOTBC and SCRMBL. 


The two inputs are assumed to be as follows: 


Reg. C = X Coordinate 0-255 (0-FFH) going left to right 
across the screen. 


Y Coordinate 0-191 (Q-BFH) going from bottom to 
top of the screen. 


Reg. B 


NOTE: This covers the full vertical range of 192 positions. 
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Bit 
SCRE 


BLOC 
(0-2 


PLOTXY 


The Y Coordinate 


is checked for valid range and reversed 


directionally so that 0 represents the top of the screen and 


191 represents the bottom. 


After this reversal, the two 


coordinates represent the following values: 


EN LINE NO. SCAN ROW 


K WITHIN 
) BLOCK 
(0-7) 


WITHIN 
LINE 
(0-7) 


X 
eit TESA ETT 


COLUMN BIT 
(0-31) (0-7) 
(O-1FH) 


We first formulate the MSB of the display file address using 
the Block and Scan Line information in the Y Coordinate: 


PUSH 
LD 
SUB 
JP 
LD 
AND 
RRA 
RRA 
RRA 
LD 
LD 
AND 
OR 
OR 
LD 


(SAVECO) ,BC 
A,191 

B 

C,ERROR 

B,A 

OCOH 


Save coordinates 
Test Y within range 


Y coordinate beyond range 
Y Coordinate now 0=Top 
Get Block No. (0-2) 

Shift Bits to Pos. 3&4 


Save Block Bits 

Y Coordinate 

Get Scan Row Bits 

Combine Block and Scan Row 
Base Address of DF (4000H) 
H = MSB of DF Address 


Next we formulate the LSB of the display file address using 
the Line information from the Y Coordinate and the Column 
information from the X Coordinate: 


LD 

RLCA 
RLCA 
RLCA 


AND 
LD 
LD 
AND 
OR 
RLCA 
RLCA 
LD 


A,C 
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Get X Coordinate 

Align to Pick Up Line 

Bits from Y 

A=2 LS Bits Column/XXX/3 MS 
Bits Column 

Clear Bits 3-5 

Save A ink 

Get Y Coordinate 

Get Line Bits 

Combine with Col.Bits 
Shift to Final Position 
A=Line #/Column 

L = LSB Display File Addrs. 


5.ea'3 


Next we get the pixel position within the byte by taking the 
last 3 bits of the X Coordinate and create a mask byte having 
all bits zero except the addressed pixel. This mask is then 
used to set the bit in the Display File. The address is set 
to Display File 2 to update the Attribute File (High Res. 
Graphics Mode is assumed to be active), and the routine is 
finished. The memory locations defined as ATTR and SAVECO 
are for illustration purposes only: 


LD A,C Get Pixel Position 
AND 7 O=Leftmost (MSB) ;7= 

: Rightmost (LSB) 
LD B,A Use as Control Count 
INC B B=1-8 
LD A,000000018 Bit Mask 

LOOP RRCA Rotate Mask Bit 
DJNZ LOOP to Proper Position 
OR (HL) OR Bit into DF 
LD A, 20H 
OR H Set Bit 13 for DF2 
LD H,A HL = Attribute File 
LD A, (ATTR) Get Attribute Byte 
LD (HL),A Update Attribute File 
POP BC Original X/Y to BC Regs. 
RET 


Repetitive calls to this routine with the appropriate X/Y 
Coordinate values will "draw" on the screen. The System ROM 
routines for drawing lines and circles calculate’ the 
successive X/Y Coordinate values and use common low-level 
routines similar to the above to place each pixel in the 
display file. 


64-Column Mode 


In this mode, set by writing to Port OFFH with Bits 0-2=6 
(Bits 1 and 2 set) and Bits 3-5 selecting ink color (0-7), 
the pixel data portions of the two display files are merged 
by the hardware on an alternating column basis to produce 
64-columns across the screen. All even columns (0,2,4....62) 
are derived from the primary display file and all odd columns 
(1,3,5..... 63) are derived from the second display file. 
There are still 24 lines vertically from top to bottom. The 
attributes are controlled by bits 3-5 written to Port FFH 
selecting one of eight ink/paper combinations. The Bright 
and Flash attributes are fixed at 0 and the Border is fixed 
to match the paper color. The Attribute Files in RAM at 
5800H-5AFFH (primary display file) and 7800H-7AFFH (second 
display file) are not utilized in this mode. 
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5.2.4 


Software supporting this mode must set up the display file 
address for character insertion based on the column position 
(even=DF1; odd=DF2). When scrolling the screen (or a portion 
of it), any line of text on the screen requires the same 
operation to be done at the corresponding locations in each 
display file. This is also true to clear the screen (or a 
portion of it). To save a Screen on tape you must save two 
Code files, one for each display file. The SAVE filename 
SCREEN$ will work for the Primary Display File only. You 
will have to specifically SAVE the second display file via a 
SAVE filename CODE 24576,6144. Note also that because the 
Border color is fixed by the video mode, you will not see the 
usual "stripes" during a tape operation. 


Code to support an 80-column mode screen was developed 
utilizing the 64-column hardware mode and redefining the 
character size to a 6 X 8 pixel group (there is really room 
for 84 characters if the full 256 pixel width is used). 
Since individual characters now can span the two display 
files (e.g. 2 pixels in DF1 and 4 in DF2) insertion of data 
into the display files involves masking the 6-bit character 
(or portion thereof) with the 8 bits of data read/written 
from/to the display file. 


Appendix C contains descriptions and code listings of 
software packages supporting 64 and 80-Column modes. 


Other 


Appendix C also contains software packages supporting the 
following video screen features: 


A, 40-Column Mode - utilizes the 6 X 8 character set 
defined for 80-Column Mode in "normal" mode. May be 
combined with the Dual Screen package. 


B. Sprites - supports movement of software-defined objects 
and multi-directional screen scrolling services in the 
Primary Display File. You must create the actual bit 
map defining the shape of your sprite(s), but this 
package does the rest. 
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5.3 Other Advanced Concepts 


5.3.1 


Interruption Fielding 


For a machine code program executing in the Home RAM, you can 
intercept the 17 ms. interruption for your own purposes by 
permanently enabling Chunk 0 in the Extension ROM Bank (write 
a 1 to Port OF4H and always have Bit 7 of Port OFFH = 1) and 
inserting at Location 25262 (62AE Hex) a branch to your own 
interruption handler. (Or if VIDMOD is not zero, insert your 
branch instruction at Location 64110 (FA6EH).) By doing this 
you are forcing the interruption to branch to the RAM and 
then bypassing the OS RAM Interruption Handler - see Sections 
3.2.2.1 and 3.3.3.1. Because the Video Mode Change Service 
automatically updates internal branch addresses in the OS RAM 
code when it is relocated between Chunk 3 and Chunk 7, you 
probably do not want to directly overlay the OS _ RAM 
Interruption Handler with your own code if you will be using 
the Video Mode service. Your branch instruction at 62AEH, 
however, will be copied unmodified to location FA6EH in Chunk 
7 and vice versa. 


Note that this technique cannot be used if you are using 
BASIC since then you must have Chunk 0 enabled in the Home 
Bank. It also cannot be used from a cartridge because the 
Memory selection hardware (Port OF4H) is common to the Dock 
and Extension ROM Banks and can only enable one of them at a 
given time as selected by Bit 7 of Port OFFH. 


5.3.2 BASIC AROS Variables 


In order to use pre-defined arrays and/or other BASIC 
variables, store them in the cartridge (possibly in the lower 
half of the addressable space which is not usable for BASIC 
program) and branch to a machine code routine via the USR 
function at the beginning of your BASIC AROS program. Use 
this routine to do the necessary memory selection and copy 
your data from the cartridge to the RAM (address in VARS). 
Adjust the System Variables E LINE, WORKSP, STKBOT and STKEND 
to all point to the first free memory following your 8ASIC 
variables. Of course, all BASIC variables must conform to 
the format expected by the BASIC Interpreter. In addition to 
BASIC structures, you can also store screen images and 
machine code/variables in the cartridge for transfer to the 
RAM under your control. Consider using the XFER BYTES 
service in the OS RAM. = 
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6.0 


Known "BUGS" and Corrections 


This section describes the known problems in the TS 2068 System 
Software and gives corrections or work-arounds where these have 
been defined. 


6.1 LROS and Autostart Machine Code AROS 


6.1.1 If you will be using the System ROM Keyboard routines 


6.1 


6.1. 


5.1 


<t 


3 


4 


and accessing the input character code from system 
variable LAST K (5CO8H), you must initialize the TS 
2068 to "L" mode by setting the system variable MODE at 
23617(5C41H) to zero and setting Bit 3 of FLAGS (23611 
-5C3BH) to 1. (The TS 2068 is in "K" mode when control 
is passed from System Initialization to the Cartridge; 
Keyword Token codes will be placed in LAST K instead of 
character codes. ) a 


If you will be using the System ROM Calculator routines 
(RESTART 40 (28H) ) or any ROM routines that invoke 
them, you must initialize the System Variable MEM by 
doing the following: 


LD HL, 5C92H Set HL=MEMBOT 
LD (5C68H) , HL Initialize MEM 


Chunk 3 must not be designated as "in use" by the 
Cartridge Memory Selection Specification byte. This 
will cause deselection of the bank switching code prior 
to completion of the transfer of control to the 
cartridge starting address. NMnce control has been 
transferred, the cartridge code may then enable Chunk 3 
in the Dock Bank if desired. (See Section 5.1.) 


No entry is made in the System Configuration Table for 
an AROS if an LROS is present. This means that an LROS 
designed to support either RAM based or cartridge based 
applications must include code for detection of an AROS. 


6.2 Machine Code AROS 


When setting the AROS Overhead parameter requesting RAM space 
for machine code variables, 21 + n bytes (15H + n) must be 
requested where n is the number of bytes needed. The machine 
language variables area then starts at 6855H immediately 
following the 21-byte CHANS area. (See Section 5.1.2.3.) 

NOTE: 
BASIC and machine code. 


This does not apply to an AROS that contains both 
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6.3 BASIC AROS 


6.3.1 


6.3.2 


6.3.3 


USR Function - When testing the USR address against 
the Cartridge Memory Selection byte to determine if 
the address is in the Home Bank or the Dock Bank, the 
wrong nibble is tested in the register thus a valid 
cartridge address could be erroneously processed as a 
Home Bank address. Since the ROM code cannot be 
corrected, the machine code in the cartridge would 
have to be moved to an address that does not cause a 
problem. 


FOR/NEXT - If the limit of the FOR statement has 
already been passed on its initial execution, (e.g. 
FOR A=1 TO 10 and A has been set to 12), control is 
passed to the statement following the corresponding 
NEXT. In the AROS support code, the address of this 
statement is lost giving unpredictable results. Since 
the ROM code cannot be corrected, care must be taken 
not to use this technique in an AROS Cartridge. 
Normal usage of FOR/NEXT loops is not affected. 


Advanced Video Modes - Because the BASIC AROS support 
code interfaces directly to the Bank Switching code in 
Chunk 3 (does not access based on its relocatability), 
the second display file cannot be open when executing 
BASIC program from an AROS. 


6.4 Video Mode Change Service 


6.4.1 


Available Memory Test - When the size of memory needed 
is calculated by adding the size of the second display 
file (6912 bytes or 1B00H) to the memory now in use 
(address in System Variable STKEND), the code fails to 
check for overflow. Thus if the address in STKEND is 
greater than 58623 (E4FFH), the fact that there is not 
enough free memory to open the second display file 
will not be detected and the system will "crash". If 
your BASIC program and/or variables area are large, 
you may want to make this test yourself prior to 
invoking the Video Mode Change Service in order to 
avoid this problem. The size of memory needed is 


subsequently tested against the contents of RAMTOP and 


if there is not sufficient space (value in RAMTOP jis 
less than size needed), you will get Error 4, Out of 
Memory. 
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6.4.2 


6.4.3 


6.4.4 


RAMTOP - When the machine stack and OS RAM code is 
moved to Chunk 7, the User Defined Graphics area is 
moved down in RAM by 2112 bytes (840H) to make room 
for the stack and OS RAM routines at the top of 
memory. The pointer in UDG is updated, however, the 
value in RAMTOP is not modified to insure that the 
relocated UDG area as well as the OS code and stack 
are protected from expansion of the BASIC program. 
You can avoid problems by setting RAMTOP via a CLEAR 
command specifying an address no greater than 63255 
(F717H) prior to invoking the Video Mode Change 
Service. This reserves space between RAMTOP and the 
end of memory of 2280 bytes (8E8H) utilized as: 


168 bytes (A8H) User Defined Graphics (21 X 8) 
2112 bytes (840H) Machine Stack and 0S Routines 
2280 (SESH) 


Example: RAMTOP = 63255 (F717H) 
+ Reserved Area 2280 (Q8E8H) 
65535 (FFFFH) 


The software packages in Appendix C are written 
assuming that RAMTOP is set to 57343 (DFFFH) or lower 
to protect the machine code which is loaded beginning 
at 57344 (EO00H). 


NEW Command - If you have used the Video Mode Change 
Service to open the second display file and now wish 
to execute the NEW command, you should first return 
the computer to "normal" mode by calling the video 
mode service with A=zero. This returns the User 
Defined Graphics and other RAM structures to their 
normal locations. If you don't do this, the UDG area 
will remain in the alternate location and, if you have 
not corrected RAMTOP as explained above, part or all 
of your UDG area could be cleared to zeros by the NEW 
command, 


VIDMOD - When Mode 128 (80H) is designated for 
activating the Primary Display File in Dual Screen 
Mode the System Variable VIDMOD at 23746 (5CC2H) is 
set to zero instead of to 128. This creates a 
potential problem if the 17 ms. interruption occurs 
before VIDMOD can be corrected since the interruption 
fielder will branch to Chunk 3 instead of to Chunk 7 
and Chunk 3 is now in use for the second display 
file. This problem is corrected by disabling the 
interruption prior to calling the Video Mode Change 
Service and setting VIDMOD to the correct value prior 
to re-enabling it. These corrections are included in 
the Extension ROM Interface Routine in Figure 3.2. 2-2, 
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NOTE: On an initial access changing video mode from 
normal to Mode 128, the interruption is re-enabled 
within the Video Mode Change Service itself after 
copying the stack and other Chunk 3 data to Chunk 7. 
This cannot be corrected, hut has not proven to 
present a problem in actual use. At the point where 
the interruption is first enabled, the Chunk 3 code is 
still intact allowing for correct processing of one 
interruption, and the path length from there to the 
point of correcting VIDMOD is apparently less than 17 
ms. The interruption is also re-enabled within the 
Video Mode Change Service if you have applied the 
patches for the BANK ENABLE and RESTORE STATUS 
routines (Section 6.5.4) which are executed in 
connection with inserting space into the RAM to open 
the second display file. Again, this has not proven 
to be a problem in actual use. 


6.4.4 Interruption Inhibit - By setting Bit 6 of Port OFFH 
to a 1, the normal 17 ms. interruption generated from 
the SCLD to the Z80A CPU will be inhibited. When Port 
OFFH is written to by the Video Mode Change Service, 
Bit 6 is forced to zero. If you wish to inhibit the 
normal interruption via this mechanism, and also plan 
to use the Video Mode Change Service, it is 
recommended that you first invoke the service to remap 
the RAM and open the second display file, then set Bit 
6 of Port OFFH to inhibit the normal interruption and 
write your own routine(s) for subsequent changing of 
the video mode setting that do not involve remapping 
the RAM. In this way you can maintain the value in 
Bit 6. 


6.5 OS RAM Routines 


In patching the OS RAM routines, care must be taken not to 
relocate CALL and JP instructions since this affects the 
modification of the code when it is moved between Chunks 3 
and 7. All of the code containing actual addresses must be 
modified to reflect the relocation and this is done using a 
table in the Extension ROM. Since the table cannot be 
changed, none of these instructions can be moved. Also, any 
CALL or JP instructions added must be modified by you when 
the code is relocated. 


6.5.1 Function Dispatcher -For a variety of reasons such as 
conflict with use of the IX Register, incorrect 
entries in the ROM Function Dispatcher Jump Table, 
etc. some Service Codes have been deleted from the 
Function Dispatcher table (Table 3.3.4-2). In 
addition, the following correction to the GET STATUS 
routine is required in order to successfully utilize 
the Function Dispatcher from a cartridge. 
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6.5.2 


6.5.3 


6.5.4 


6.5.5 


6.5.6 


GET STATUS- Returns invalid memory selection status 
for the Home Bank, ROM Extension and Dock. This 
results in switching out of either the Home Bank or 
the Dock when status is "restored". This affects use 
of the Function Dispatcher and GET WORD routines, and 
any other code using GET STATUS. “Figure 6.5-1 shows 
the patches and additions necessary to correct this 
routine. 


PUT WORD- Write data passed in Reg. Pair DE is 
overwritten prior to use. Figure 6.5-2 shows 
corrections. 


BANK _ENABLE and RESTORE STATUS- 


If the 17 ms. interruption occurs during update of the 
memory selection hardware, it can cause the system to 
hang and RAM to be overwritten. This occurs when the 
interruption happens in an interval when Port FF Bit 7 
is zero (thus selecting the Dock Bank) and Port F4 Bit 
0 is one (thus enabling Chunk O in the Dock Bank) and 
there is no memory in Chunk O of the Dock Bank. This 
can be true when there is no cartridge installed, or 
if the cartridge installed is an AROS. This problem 
is corrected by disabling or masking the interruption 
while updating the memory selection hardware. Figure 
6.5-3 shows one implementation of this correction. 


SAVE STATUS and RESTORE STATUS - The value of Port FFH 
which includes video mode and interruption inhibit as 
well as Ext. ROM/Dock Select is saved and restored as 
a full 8-bits. Therefore any modification of this 
port by code accessed between execution of SAVE STATUS 
and subsequent execution of RESTORE STATUS (e.g. via 
CALL BANK or use of the Function Dispatcher) is 
"undone". This is one reason the Video Mode Change 
Service and some of the bank switching routines such 
as BANK_ENABLE cannot be meaningfully accessed via the 
Function Dispatcher. 


CALL_BANK- Does not correctly retrieve the stack 
entry designating the count of parameters being 
passed, Memory is overwritten in the case where this 
count is not zero. This is corrected by setting 
Location 6610H = 9 (POKE 26128,9). You only need to 
apply the correction once; it will be duplicated in 
Chunk 7 if the code is relocated. 
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+ +e et FH OF OH FF OF 


2 . 


LOCATION 


6405 
6406 
6407 
6408 
640A 
640C 
640E 
6410 
6411 
6413 


6430 
6432 
6434 
6436 
6438 
643A 
643C 
643E 
6440 
6442 
6444 
6445 
6447 


6449 
644A 
644B 
644C 


The asterisks mark the locations modified. 


OBJ. CODE 


FIGURE 6.5-1 


GET STATUS CORRECTIONS 


SOURCE STATEMENT 


COMMENTS 


Input: Bank # in B 


Output: Bank # in B (Bank Status if Exp.Bank) 
Memory Selection in C 
(Low Active Format) 


GET STATUS PUSH AF Save Regs. 
~ PUSH DE 
LD A,B Get Bank # 
cP OFEH Test if Ext. (254) 
JR = Z,GS_EXT 
cP OFFH Test if Home(255) 
JR Z,GS HOME 
AND A ~— Test if Dock (0) 
Z,GS_DOCK 


JR 


GS_EXT LD 


GS DOCK = LD 


GETHS IN 


GS HOME IN 


GS_XTO LD 
GS"XTI POP 


corresponding POKE's for BASIC. 
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(Code for Expansion Banks 
not applicable) 


C,OFFH Assume none 
A,(OFFH) Test if selected 
80H 

Z,GS XT1l_ Not active 
GETHS: Get Hor.Select 
C,OFFH Assume none 
A,(OFFH) Test if selected 
80H 

NZ.GS XT1 Not active 


A,(OFFH) Get Hor. Select Reg. 
Invert to Low Active 


GS XTO Exit 


A, OF4H All bits set are not 
active in Home Bank 


CA Memory Select to C 
DE Restore Regs. 
AF 

Return 


See next page for list of 


FIGURE 6.5-1 


GET_STATUS CORRECTIONS 


(continued) 


From BASIC: 


POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 


25610, 40 
25611, 36 
25614, 40 
25615, 55 
25617, 40 
25618,39 
25648 ,14 
25649, 255 
25650, 219 
25651 ,255 
25652, 230 
25653,128 
25654, 40 
25655,18 
25656, 24 
25657 ,8 
25658 ,14 
25659, 255 
25660, 219 
25661, 255 
25662, 230 
25663,128 
25664 , 32 
25665 ,8 
25666,219 
25667 , 244 
25668 , 47 
25669, 24 
25670,2 
25671,219 
25672, 244 
25673,79 
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(Location 640AH) 
(Location 640EH) 
(Location 6411H) 
(Location 6430H) 


+ + + + & 


LOCATION OBJ.CODE 


633B 
633C 
633D 
6340 
6341 
6342 
6343 
6346 
6347 
634A 
634B 
634C 
634D 
6350 
6351 
6352 
6353 
6354 
6355 
6356 
6359 
635A 
635B 


The asterisks mark the locations modified. 


From BASIC: 


NOTE: 


POKE 25408,213 
POKE 25424,193 
POKE 25425,209 
POKE 25426,115 
POKE 25427,35 

POKE 25428,114 
POKE 25429,43 


FIGURE 6,5-2 


PUT WORD CORRECTIONS 


SOURCE STATEMENT 


COMMENTS 


Input: Data in DE, Address in HL, Bank # in B 


PUT WORD — PUSH 
PUSH 
CALL 
PUSH 
LD 
LD 
CALL 
PUSH 
CALL 
CPL 
LD 
LD 
CALL 
POP 
POP 
LD 
INC 
LD 
DEC 
CALL 
POP 
POP 
RET 


AF 
BC 
GET NUMBER 


GET STATUS 
BC 
GET CHUNK 


B,D 
C,A 
BANK_ENABLE 
BC 

DE 

(HL),E 

HL 


(HL) ,D 
HL 
BANK_ENABLE 


BC 
AF 


Save Regs. 


Bank # of Owner 
Save Data 

Save Target Bank # 
Bank # of Owner 
Get Bank Status 
Save It 

Get Bit Map 

Set High Active 
Target Bank # to B 
Memory Select Byte 
Enb1. Target Mem. 
Saved Bank Status 
Saved Data 

Write LSB 
Increment Adrs. 
Write MSB 

Restore HL 

Restore Bank St. 
Restore Regs. 


Return 


The corrections to GET STATUS and BANK ENABLE are also required. 
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FIGURE 6.5-3 
BANK_ENABLE AND RESTORE STATUS CORRECTIONS 


From BASIC 

BANK ENABLE: Location Object Code POKE Address Value 

6499H 00 NOP 25753 0 

649DH F3 DI 25757 243 

651CH FB EI 25884 251 
RESTORE_STATUS: 

654AH F3 DI 25930 243 

6570H FB EI 25968 251 


In both cases, the Disable Interrupt and Enable Interrupt are being done 
by deleting the preservation of the AF Registers (PUSH AF/POP AF). If 
your code requires AF to be saved, you must do it prior to calling either 
of these routines or any other system routines that use them. Note also 
that if you already have the interruption masked when these routines are 
entered, it will be enabled when they are exitted. If this proves to be 
a problem, replace the Enable Interruption (EI) instruction with a NOP 
and do the enable at a more appropriate place fin your own code. 


6.5.6 GET NUMBER- Always returns the Dock Bank # for any 
memory enabled in the ROM Extension. Unlikely to be a 
problem because of limited use of the ROM Extension. | 


6.5.7 XFR_BYTES- Improperly passes memory select byte for 
the case where source and destination are in the same 
bank. This is corrected by setting Location 676AH = 
BFH (POKE 26474,95). 


6.6 GENERAL 


6.6.1 Pressing ENTER multiple times with an invalid tape 
command on the edit line (syntax error) causes the 
system to reset. This is due to overflowing the Bank 
Status Stack in RAM Chunk 3/7 due to the multiple calls 
to and from the Extension ROM via the Call Bank code 
without normal termination (the error causes a RESTART 
8 to be executed out of Home ROM code called from the 
ROM Extension). It shouldn't take anybody that many 
tries to get a tape command right, so this is not a 
real problem, but you may want to keep it in mind. For 
any call made through the OS RAM services, you should 
have a corresponding return to keep the structures . 
clean, 
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6.6.2 


6.6.3 


6.6.4 


6.6.5 


ON ERR GOTO - If a non-existent Tine number is 
specified, followed by an error, the system will hang. 
The ROM code is in an endless loop trying to report the 
absence of a valid error handler to the non-existent 
error handler::: On some errors, you will get an 
unexpected 0 OK termination showing the line number of 
your Error Handler. This is because some ROM routines 
temporarily clear the INTPT Flag (Bit 7 of FLAGS). 
This flag is set to 0 when checking syntax and set to 1 
when executing; if an error is detected while the 
Flag=0, the error handler code is branched to but is 
not executed. 


Parameters to the SOUND command are not fully 
validated, therefore you can specify a number beyond 
the valid range for a given operation and not get an 
error, for example, you can write a value greater than 
63 to the Enable Register (Reg.7), possibly changing 
the I/0 Port used for reading the joysticks from input 
to output. If you specify a number larger than 255 
(FFH), only the least significant byte will be actually 
written to the Programmable Sound Generator. Access to 
PSG Reg. 14 (I0O-A) used for the Joysticks is also not 
precluded via the SOUND command. 


If you experience difficulty in reading the 
joystick(s), do a write to PSG Req. 7 clearing Bit 6 to 
0 to guarantee that the joystick path is enabled for 
input (see Section 4.3). This write can be done by 
executing a SOUND 7,63 (or any value less than 63). 


The INTEGER function for (-65536) gives an incorrect 
result of -1, and for other cases where the result 
should be -65536, it gives -1E-38. Since the ROM code 
cannot be changed, there is no correction. 


If you respond to the SCROLL? message using multiple 
keys such as Cap Shift/2 or Cap Shift/Symbol Shift, you 
will get strange results like dumping of the Edit Line 
with the "C" or "E cursor, display of ROM data, or 
multiple scrolls. Stick to single key responses and 
you won't have any problems: 


When DELETE (Cap Shift/0) is held down to do deletion 
of characters in the Edit Line, sometimes it outputs 
the DELETE Keyword instead (it should not do this in 
auto-repeat mode). This is especially noticeable when 
the input line is long. Since the ROM code cannot be 
corrected, you must try releasing and pressing the 
DELETE key at differing frequencies and you will be 
able to get past this "Bug". 
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APPENDIX A 


HOME ROM MAP 


LINK 1.7 DATS 1ES2 SYNTAX 
DEF 2010 SYNTAX 
LOAD MAF DELREC 1750 LIST 
MODULE ORIGIN LENGTH DELZYM OR7E If_2 
QOEL_DE 1743 LIST 
BLOCK 0000 = 9000 OEL_K. OBFD 102 
BASIC 0000 0227 DESLUG opon 10.2 
KSCAN 0227 O2D9 DIEHL 1462 LIST 
iat o500 a502 DIGIT? 3009 INOUT 
Ia_2 OAOZ O31B DIM ZFCO IDENT 
ELIT opin 04282 OIVIoE BS6E SUMS 
CHANS 139F 90142 DIRAW 2608 GRAPHS 
LIST 1461 O2D4 DRAWLN 2313 GRAPHS 
ARNIS 1785 0190 DRAW LL 2910 GRAPHS 
SYNTAX 1745 Ok0A QUMPPR OA2Z3 I0_2 
SYNTWO 214F 484 nvanic 1B0C SYNTAX 
GRAPHS 2603 O251 ECHO OTRS IG_2 
EXPRN 2354 041¢ EDIT_K OASZ 102 
IDENT 2070 Q2E>? END? 1B44 SYNTAX 
INQUT 2059 O301 ENDSTT 1ABR9 SYNTAX 
SLIMS 225A O3ZA ENDTEM 1B4A SYNTAX 
CALC R624 0437 ERASE Zona SYNTWO 
FUNCTS 2ABB O1ceE ERR2 1B91 SYNTAX 
TAPEMSG 3ca9 860053 ERR4S FCF SYNTAX 
CH SET 2n00 0200 ERRS Q7C1 Iai 
ERRS S540 SUMS 
GLOBAL ADDRESS MODULE ERRB 1F29 SYNTAX 
ERRH 237E SYNTWO 
ATS SCSE FLUNCTS ERRO® 12:2D EDIT 
aca 330% SUMS EXCUTE 1Ans SYNTAX 
ALNUM? 2044S IDENT EXP SADF FLUNCTS 
ALPHA? 3048 IDENT EXFRN 2954 EXPRN 
ANGLE SEPE FUNCTS FIND_L 1404 LIST 
ARIS 1204 ARQS FIND_N 2070 IDENT 
ARRAY S703 calc FIX_t 1F23 SYNTAX 
AR_LN 17EA arRos FIX uy 1FiIE SYNTAX 
AR_NXT 17FF =oARQOS FLASHA 1400 LIST 
ASN Sn4e FUNCTS FLOAT 3G56 SLIMS 
ATN SBFD FUNCTS FOR 1G73 SYNTAX 
ATTBYT 0710 TOU FORMAT 25CC SYNTWO 
BEEP 434 KSCAN FP2A 3193 INOUT 
BORDER 243E SYNTWO FP2EC 31460 INQUT 
BREAK? 2009 SYNTAX FLATTR 2307 EXPRN 
CAT PSs SYNTWO FLINEY 2UF 2 EXPRN 
CHCOADE O371 KSCAN F_LPI 29E5 EXPRN 
CHINIT 11AA EDIT F_LENT 2624 GRAPHS 
CHE. _SZ 1FBB SYNTAX F_SCRN 223F EXPRN 
TIRCLE 2479 GRAPHS GETAL 17CF AROS 
CLOHAN 12BE CHANS GETLEL 2034 IDENT 
CLEAR 1F34 SYNTAX GET_LN 1224 EDIT 
CLEL 133F EDIT GET_XY 2460 GRAPHS 
CLLHS OBA? 101 GO_SUB, 1F99 SYNTAX 
CLOSE 139F CHANS GR-COL 233C SYNTWO 
CLPR OAZS 1a_2 HIFLSH 2410 SYNTWO 
CLR_EC 1F39 SYNTAX INCH 11E1 EDIT 
CLs ORBEA IOL1 ININT ZOF9 INQUT 
CLS_B OO7F 10.1 INIT ops. ELIT 
COLITM 2204 SYNTWO INPUT 2228 SYNTWO 
COLCUR 230E SYNTWO INST 1288 EDIT 
CONT 1EE4 SYNTAX INSA OAE7 10.2 
cos 3BCS FUNCTS INSERT 12BB EDIT 
CP_BC 14E8 LIST INT SACA FIUNCTS 
CTRO 371A CALC INTOIV 2ABB FUNCTS 
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INTPT? 
INK 
I_SEQ 
LIMP 
K_BASE 
K-CLS 
K_ DUMP 
K-LIST 
KLLST 
KULPR 
K_NEW 
K_PRIN 
K.SCAN 
LCUu2 
LDDE 
LDMES 
LOTVCU 


NEGATE 
NEW 
NEWDEV 
NEXT 
NEXTCH 
NEXT_L 
NOTKB? 
NXT_HL 
QPCHAN 
OPEN 
OP TNO 
OUTPUT 
PAEDCB 
PARP 
PASSEM 
PAUSE 
PHLAF 
PLOT 
PLOTBC 
PLUGIN 
POPSTR 
PRSCAN 
FR_CUR 
PR_TV2 
PSHSTR 
PUT 
PUTDIG 
PUTMES 
PUT_BC 
PUT_LN 
PUT_SR 
PLLFT 
PLNL 
P_LRT 
PLE 
RAMNI 
ROny 
RDOCH 
REAR 
RECLEN 


2289 
CZOE 
2266 
1EF1! 
O3SC 
OBAG 
QAG2 
1345 
1341 
2155 
oo1D 
2159 
O2B0 
13265 
213D 
SCAS 
QS1A 
OQos5 
OEZF 
OESD 
2EBD 
1768 
14E% 
2B2E 
15AC 
1A&4 
1 BEC 
25D0 
3464 
0077 
2820 
OD22 
2402 
1D55 
0074 
165B 
2280 
2049 
1465 
142A 
1049 
BIAL 
2E74 
O3F3 
25B9 
1FEB 
OO4F 
2635 
263E 
9000 
2FAF 
OA4SA 
162D 
0776 
2&70 
15c9 
11EA 
O73F 
17383 
1793 
15A1 
O33A 
0564 
OSS 
Z17E 
377F 
1E04 
11CF 
1097 
1720 


EXPRN 
TQL2 
SYNTIUNG 
SYNTAX 
K SCAN 
Tai 
10.2 
LIST 
LIST 
SYNTWO 
EDIT 
SYNTWO 
KSCAN 
EDIT 
INOUT 
TAPEMSG 
Ig.1 
BASIC 
EDIT 
EDIT 
IDENT 
LIST 
LIST 
FUNCTS 
LIST 
SYNTAX 
SYNTAX 
SYNTWO 
SUMS 
BASIC 
CALC 
EDIT 
SYNTWO 
SYNTAX 
BASIC 
LIST 
SYNTWO 
EXPRN 
CHANS 
CHANS 
SYNTAX 
INQUT 
IDENT 
KSCAN 
SYNTWO 
SYNTAX 
BASIC 
GRAPHS 
GRAPHS 
BASIC 
IDENT 
10.2 
LIST 
IO 
IDENT 
LIST 
EDIT 
I0_t 
LIST 
LIST 
LIST 
IG_t 
19.1 
TH 1 
3SYNTWO 
CALC 
SYNTAX 
EDIT 
SYNTAX 
LIST 


REMGSZ 
RESET 
RESTBEC 
RETURN 
RND 
ROOM? 
ROOT 
RSET 
RETSTR 
RATTS 
SCRL 
SCRMBL 
SEARCH 
SELECT 
SEL_HL 
SENDCH 
SENDTV 
SEPRMT 
SETCUR 
SETTVC 
SET_AT 
SHIFT 
SIN 
SKIP 
SKIPIT 
SLICER 
SMINIT 
SQUND 
SRCHSC 
STBOOL 
STDE_S 
STDE_U 
STKIUSN 
STK_O 
STK_A 
STK_BC 
STK_M 
STOP 
STRITO 
STTvcu 
SUB 


TEMP33 
TEMP39 
TERM? 
TESTO 
TIMES 
TOKENS 
TO_THE 
TRUNC 
TVFUL? 
TV.COL 
UPD_K 
USRRET 
WRCH 
XEY 
XCALC 
X_T_HU 


12CA 
1334 
1ECA 
1FD4 
29BA 
3768 
2065 
2484 
13A8 
0338 
939 
2403 
124B 
1230 
1243 
11ED 
0500 
3C39 
o914 
o914 
OFB2 
339¢ 
3BD0 
1D238 
2t49 
2E19 
4102 
2123 
1374 
3926 
314¢ 
314A 
sO059 
1cS1 
SOE6 
30E9 
3773 
1c59 
220F 
OSF3 
33CE 
16F0 
16F3 
3379 
1BED 
1A27 
SBFS 
0078 
1BS2 
1BEF 
1BES 
19E0 
19E1 
21E7 
3904 
3439 
0078 
3C4r 
3503 
0790 
228B 
O2ZEL 
3232 
0010 
3100 
134E 
1343 


EDIT 
EDIT 
SYNTAX 
SYNTAX 
EXPRN 
CALC 
FUNCTS 
SYNTWO 
CHANS 
To_1 
10_1i 
GRAPHS 
EDIT 
EDIT 
EDIT 
EDIT 
TO! 
TAPEMSG 
10.1 
TO.1 
To.1 
SUMS 
FUNCTS 
SYNTAX 
SYNTWO 
IDENT 
EDIT 
SYNTAX 
EDIT 
CALC 
INOUT 
INOUT 
INOUT 
SYNTAX 
INOUT 
INOUT 
CALC 
SYNTAX 
SYNTWO 
TO.% 
SUMS 
LIST 
LIST 
SUMS 
SYNTAX 
SYNTAX 
FUNCTS 
BASIC 
SYNTAX 
SYNTAX 
SYNTAX 
SYNTAX 
SYNTAX 
SYNTWO 
CALC 
SUMS 
BASIC 
FUNCTS 
SUMS 
TOL! 
SYNTWCO 
KSCAN 
CALC 
BASIC 
INOUT 
EDIT 
ENIT 


PROGRAM BLOCK -~ 4000 BYTES 


ENTRY: 0000 
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EXTENSION ROM MAP 


LINK 1.7 

LOAD MAP 

MODULE ORIGIN LENGTH 
XBASIC 0000) —=— «0068 
TAPE 0063 087F 
INIT O8E7 04C9 
CHNG_VID ODBO 0193 
PASSING OF43 0047 

BS OFBA OO1E 
GLOBAL ADDRESS MODULE 
AKEY Q8SAA TAPE 
BLDSCT O9F4 INIT 
CALL_B OF 99 BS 
CHNG_V OESE CHNG_VID 
CLDFIL OE27 CHNG_VID 
EXINIT O8E7 INIT 
GOTO_B OFSA BS 

LOAD oscc TAPE 
MERGE O6ES TAPE 
OPDF IL ODBO CHNG_VID 
PASSIN OF 43 PASSING 
RD_BIT 0189 TAPE 
RESSCT oc4ac INIT 
R_EDGE 013D TAPE 
R_TAPE OOFC TAPE 
SAVE 0351 TAPE 
SLVM O1AB TAPE 
W_BORD O0ES TAPE 
W_TAPE 0068 TAPE 


PROGRAM XBASIC ~- 1000 BYTES 
ENTRY: 0000 


DISPATCH 1000 0624 THIS MODULE IS COPIED TO RAM 6200 (space reserved 6200-683FH). 
GLOBAL ADDRESS MODULE Relocated to RAM F9OCO-FFFFH when second Display File is used. 
BANK_E 6499 DISPATCH 

BS_MAX 6315 DISPATCH 

BS SP 65CE DISPATCH ORIGIN LENGTH 
cATL_8 6500 DISPATCH 

CREATE 66E8 DISPATCH TABLES: FIXTBL 1000 007C 
DISPAT 6200 OISPATCH 

GET_CH 6440 DISPATCH JUMPTBL 1£0¢ 0124 
GET_NU 645E DISPATCH 

GET ST 6405 DISPATCH UNUSED: 1624 060C 
GET WO 6316 DISPATCH 

GOTO _B 6572 DISPATCH 107¢ 0160 
GOTO_E 6815 DISPATCH 

INT A2AE DISPATCH 
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toc OR! CODE M TMT SCUIRCE STATEMENT AIM 5.9 


4.0 @LIST OW 
421i aLISTt ON 
42 #INELIOE NEW_SVEVARS. 3 


423 ' MERE ARE OME NEW SY STCM VARIABLE DEF INIT Dans 
aca oft 
45 3 E 
426 STKSZ Eu Lote 
427 =SAaDDPT Equ OF St ISOUND CHIP ADDR PURT 
426 <DATPT Eq) OF 6H SSOUIND CHIP PATA FORT 
42° HS equ 40H 
430 HELLSN ECs HS 
431 BNA Eou 20H 
432 HtIMSN EC! BNA 
433 ABN eau ORO 
434 HSF Ete ABN sHS° REG ADDR 
433 STALL ite) ABN 
426 «CMD ec OC On 
437 STALO cou chp 
43% LOWNYB Equ OC OMS tRESET NYBBLE STEERING LOGIC CMD 
437 FREE_BYTES EQu 32 
440 PROUT cou 3 
441 HOR_SEL cou 19 
442 BANK EQu 11 
443) PDK EQu OZE1H 
444 (1 
445 
446 
447 GLOBAL DISPATCH. INT, NMI. PUT_WORD. GETLWORD 
443 GLOBAL WRITE_BS_REG, READ_89.RES. GET.STATUS. GEY_NUMBER 
aac GLOBAL GET_CHUNK, BANK ENABLE. GOTO_BANK, CALL BANK 
450 GLOBAL XFER_BYTES,. BS_MAX_BANK. B3_5P 
aa GLOBAL CREATE_BITMAP, MOVE_BYTES 
452 
453 +t DISPATCH (SVC_CODE!t PASSED ON STACK) 
454 6 
453 os SVC_CODE 1S A 16 BIT QUANTITY. BIT 15 1S USED AS A JUMP FLAG: IF 
a% of SET. THE DISFATCHER WILL DD A OOTO_BANK TO THE SPECIFIED ROUTINE. 
an7 4 OTHERWISE 17 WILL DO A CALL_BANK. 
asa + 
ane 
460 3 
461 IMP TRL Equ IFFFH 
462 LASTLEXT_SVC Eou 13 
462 LAST RAM SVC Ec 2 
64 3 
ao35 + 
446 3 
$200 467 ORG 420004 
468 
20H PHB 1 OCC? 44% DISPATCH ed Ix. a 
6208 DO3s9 470 ann IX, oF sIX = SF 
4206 cs 471i ASH eet sRELERVE A WORTH CM THE =TACK 
4207 FS 472 Fite AF SAVE REGS 
S2es ce a7 PrH he 
6209 oS 474 PUSH te 
4208 8 8=ES 475 PUSH wn 
$208 DOSEO2 476 Lo E. (ixe2) 
S20€ ODS603 a77 LD O. (1X43) 1DE © SVC_CODE 
6211 AF 473 xoR a 
6212 CB23 479 SLA E 
e214 cai2 420 RL 5 1DE = 29DE 
6216 17 481 RLA 1A | JUMP FLAG 
42137 210D00 as2 Lb HL. LAST_EXT_Sve 
621A CB2S 4n3 SLA L 
$2ic cas 494 Re 4 HL © 28H 
$21€ a7 433 AND a 
621F EDS2 aoe SBC HL. DE SCOMPARE HL AND DE 
$221 3013 437 IR NC. DLEXT vEF DE <= HL 
$223 2112300 4en LD HL. LAST_RAM_SVC 
6226 Cecs 43¢ SLA t 
223 cBI4 490 RL H 
S228 a? art ANT A 
228 EDS2 4ae2 ssc Mm. DE 
$220 390F 493 IR c. O.HOME 
$2aF OOFF 494 LD B. 253 tHERE FOR RAM-BASED SERVICES 
$231 CDOS64 ass CALL GCET_STATUS tGET STATUS OF HOME BANK 
6234 OFF 4% LD 8. 255 $BC = HOME BANK / HORI2-SELECT 
6236 1808 497 R D.SAVE 
6238 O4FE 498 DEXT Lb B. 234 ‘HERE FOR EXT. ROM BASED SERVICES 
23a OEFE a9? tp Cc. OFEM 
$23¢ 1904 "$00 R D.SAVE 
623€ OOFF 50% D_HOME LD B. 235 'SET BANK_ENABLE PARMS FOR HOME 
$240 9EOO 302 LD c. oOo 
6242 «FS 303 DSAVE PusH OF 
$243 cs 30a PUSH Bc tSAVE JUMP FLAG AND BANK ENABLE PARMS 
6244 Z1FF AF S08 LD HL. JMPTBL SCALC. ADDR OF TABLE ENTRY 
$247 37 306 scr 
62498 EDS2 507 SBC HL. De 
624A OOFE 508 to 8, 234 
624ac CD16463 50° CALL OET_WORD tREAN TABLE ENTRY 
624F Ep 310 ex DE. HL 
4230 C1 311 Por Bc 
$231 Fi S12 PoP wr SRESTORE JUMP FLAG, ETC. 
S252 a? 313 AND a 
4233 231F 514 Jr 2. OUCALL 
$238 OD71FE Sis ‘ Lo (Ix-2), C 'PUT BANK® AND HOR-SEL ON STACK 
6259 DO7OFF 316 Lo CIx-1). B 
ocSB DOSEOO 317 Lp Le (1X) SSAVE RET ADDR 
O27E 0D6401 318 LD We. (EXe1) 
S261 007403 S19 Lo (1X43). H tPUT RET ADOR BAC ON STACK 


139 


$264 DO7%H2 329 Lo C1X*2d,. 


8247 DUT 20H Sat Lo CIx+i),. BD SSET UWF STADE FOR GOTO BANK 
2b 007300 ar to (1X), € tPUT ADEA ON STACK 
4240 Et S23 ror a TRESTORE REGS 
Ose OL S24 FOP ne 
6V4F et ian) roe tec: 
4270 FL S26 FOr: ar 
S27) CUTZAS 227 CALL COTO LAAN SHERE IF JUMP FLAG NOT SET 
6274 DoEC re DoCALL [ad L. 1x) SSET UF STAT FOR CALL. RAN 
4277 DI4ao ut HW, CINe1) SPUT PRTLADDR IN PROPER LOC 
627A Et PUSH Ht. 
el7k DTSE NS to Ly ¢7TK+a) 
E27E DD4405 Lo H. (1x8) 
4251 C7 E to CIX-2), 4 
e204 On74FF LP CIx-2). H 
S227 DIME. Lt L, (iyeé) SPUT PRMLOUT IN PRPER LOC 
£230 DIGEO?7 Lb 4. (1X47) 
6220 po7 so Lp C1Xd, L 
S270 pn7401 ied (1X41). H 
E293 or7102 a (1X42), SPUT BANE @. HE ON STACH 
S296 DD7O03 Lo (3x43), 8 
S29¢ pe7a04 [eu {1xXe4). £ ePUT ADDR ON STACI 
e290 On7205 Lo (Ixe3), D 
29F €1 POF HL 
62a DO7 Sc ub CUX*Od, Lb 
62Az DD7407 tp (1x7), H 
ecAe EI POP HL tRESTORE REGS 
6207 pi PoP DE 
ZA ci PoP BC 
é2ae Fi POF aF 
620A = cHnoSS CALL CALL_BANK SHERE IF JUMP FLAG NOT SET 
620n 6 6CF RET 
' 
% 
‘RST Sét HERE TO SERVICE INTERRUPT BY READING KEYBOARD 
S2AE FS INT PUSH AF 
sar UES PUSH HL 
62kG = DDES PUSH Ix 
62BzZ 210000 tp HW. Oo 
S255 a9 apo HL. SP 
BS DS PUSH DE 
2b? BA1LSE2 S62 ip A. CBS _MAX_ BANK) 
62BA SF 343 Lb E. A 
é2BE 1600 364 in rr. @ 
4260 13 56s INC. DE 
elke 13 Se INC: te 
é2EF a7 567 ANT a 
6200 = EDS Soe SBC HL. DE 
4202 «2B 549 ex DE, HL 
6202 PL21 0000 £70 ag Ix. © 
6207 opi? S71 ana 1x, DE 
6209 oD S72 Pe DE 
620A DoF 573 Lo oP. Ix 
éace 8 CDIES 374 CALL SAVE_STATUS 
620F cs S7% PUSH ec 
6200 OFF S76 up BK. OFFH 
e202 CLOS44 377 CALL GET_LSTATUUS 
62D5 O6FF if B. OFFH 
6207 79 feu aoc 
4208 Esra ANT: OF CH 
écDAR aF ia c. a 
62DB = CD9964 Se2 CALL BANK_ENABLE 
enone Ct 583 POF BC 
620° 2a7esC 2e4 LD HL. (FRAMES) NOW INCREMENT FRAME COUNTER 
62E2 23 Ses INC HL 
4282 227850 Sa LD (FRAMES). 
62E6 7c 387 LO A.H 
62€7 BS see ORL 
62E8 2003 339 JSR ONZ-LITS 
62EA FLR3440 SPO INC (C1Y~Y*FRAMEQ) 
ece6 6S 391 LUrIrTs: PUSH BC 
62EE DS 592 PUSH DE 
62€F CDE102 393 CALL UPD_K 
62F2 IM S94 POF DE 
é2F3 Cl sot POP BC 
S96 PHLAF: ‘JUMP HERE TO POF HL. POP AF, ENABLE INTERRUFTS & RETURN 
62F4 DD21 0000 3°97 ub Ix, 0 
é2rFe BUSY sve ADE: Ix, &P 
é2FA CD4AES S99 CALL RESTORE.STATUS 
42FD = DLIZ3 . €00 Iwc Ix 
OFF DIF? 601 LD SP, Ix 
$301 DDEI 602 Por 1x 
6303 «£1 603 Por HL 
6304 Fi 604 POF AF 
6305 Fk 605 €! 
63206 ce 606 RET 
607 
608 tHERE TO SERVICE NON-MASKABLE INTERRUPT 
609 tIF (NMIADD) © 0 THEN RETURNS STRAIGHT AWAYS 
610 tELSE, JUFIPS TO (NMIADD) WITH HL (ON TOP). AF & RETN ADDR ON 
#11 i] THE STACK. 
6207 FS 612) WAI PUSH AF 
6302 Es 613 PUSH HL 
6309 2ABOSC 614 LD HL. CNMIADDD 
300 7c o1S ’ LD A. 
6300 Bt 616 ORL 
630E 2001 617 JF NZeLNI SIF NO USER-SUPPLIED SERVICE ROUTINE 
6310 = «ES 618 WP (CHL) 
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6311 €1 LNI3: POF HL 


e31s FI POF ar 
6312 Ena: RETN 

‘ 

‘ 
4315 BS_MAX_BRANK DEFs 1 tTHIE IS A COPY OF MAX DAN 


' 
1 GETLWORD (ADDR: HL. RANIER: WORTEHL) 
§ 
' 


FS GET WORD PUSH OF SSAVE REGS. 
cs PUSH eo 
re, PUSH te 
COSE em Cane GOT NRE TF: 'GET RANK @ OF faINER AP ALEH: 
re Las] AF 
sa tn O. 
a? Lo B. A 
coos4e TALL GET_STATUS 1GET STATUS UF NWNER 
snl2 0% Laue | ec 
$3223 Coane TALL GET _CHUNK (SET HS FOR NETTING AT ADDR 
4226 oF CPL CFUT IN ACTIVE LOW FORMAT 
4227 42 Lb 8B. oO 
S3RE oF Lt C1 A 
6329 CDP96E CALL BANK ENABLE SENABLE ADR 
ESRC ec to €. (Mu) tREAD THE WORD 
4320 23 INC He 
G32 bn Lo GO. (HL? 
632° 2B vec Me 
4320 es Ex CE. ML 
6331 ft PoP Be 
332 Fi PoP ar 
6333 a? to BA 
6234 CDP%44 CALL BANK_.ENABLE SREENABLE OWNER GF ADDR 
4337 D1 PoP vE TRESTORE REOS 
4328 C1 PoP Bc 
4337 FI POP OF 
£3238 cy RET 
' 
8 
§ FUT.WORD (WORD DE. ADDRt HL. BANK! B) 
' 
t) 
FS PUT_WORD PUSH Ar 1SAVE REGS 
cs PUSH Bc 
CUSES4 CALL GET _NUMBER SGET BANK @ OF CUNER OF ADDR 
FS PUSH AF 
so Lo 0. B 
47 Lp 8. A 
CO0SS4 CALL GET.STATUS tGET STATUS OF OWNER 
cs PUSH ec 
CU4DE4 CALL GET _CHUNK SSET HS FOR GETTING AT ADDR 
oF CPL #PUT IN ACTIVE LOW FORMAT 
a2 Lb 8. 0 
ar Lo c. A 
COV968 CALL BANK ENABLE TENABLE ADDR 
73 (Rt) (HL). E£ tWRITE THE WORD 
23 INC HL 
72 Lp (HL, D 
2B dec ML 
C1 Por Bc 
Fi PCP AF 
CD9964 CALL BANK ENABLE thEENABLE OWNER OF ADDR 
C1 Lk ad sc 
Fi PoP AF 
cc REY 
’ 
' 
$ WRITE_BS_REG (REGLALIORG 0. REG_DATN: E) 
q 
’ 
635 FS WRITE.BS_REG PUSH ar tSAVE REGISTERS 
6350 cs PUSH Be 
62T& ES PLUSH HL 
635F 62 Lo yw OD 
6360 2E00 LD Lt. o tHL = MEMORY MAPFED ADDR 
6362 JAGaTO Lb A. (LOWNYB) 1SAVE (OE000H) 
$365 =FS PUSH AF 
6346 7E Lp a. (HL) 1SAVE (HL? 
627 FS PUSH AF 
S348 3E07 LD a, 7 
S36Q DFS OuT (SADDPT), A tSAVE VALUES OF SOUND REGS 7 AND E 
436C DBFS IN A. (SDATPT) 
426E 47 Lb BA 
6a4F EOE uD A. OEM 
4371 O02FS aur (SADLPT). A 
4373 DBFS IN A. (SDATPT) 
4375 aF tp Cc. a 
6376 3€07 Lo a. 7 SSET 110A CHANNEL TO OUTPUT 
4278 D3FS OUT (SADDPT). A 
637A 3&40 ub A. 40H 
&37C D2F4 OuT (CSDATPT). A 
537€ 3EOE Lo A, OCH 
6380 o3F5 our (SADDPT). a 
6332 AF XxOR a 
6383 O3F6 out (SDATPT). A 
6385 2€02 LD a. 2 
4B B200C0 Lp ({LOWNYB)» A {RESET NYBBLE STEERING LOGIC 
4338 7B LD a € 
$283 7? tp (HL). a sWRITE USN OF DATA 
4533C Chor SRA a 


CB2F 720 SRA a 
Chor <1 BRA a 
CB2QF 72 BRA a 
7? 72 co (Hod, & TWRITE MSN OF DATA 
3EQ7 724 ip ae 7 SRESTORE SOUND REGS 
O23 72 fT CSADDPT)., 
76 72 Lo a B 
OoF4 727 QuT (SDATPT). A 
TE OE 728 Lo a. SEH 
DAF S Ve our (SADDPT). & 
79 730 LO a. € 
O3F4 73 OT (SOATPT). A 
Fi 732 FOP AF 
77 722 Lo (HL). A TRESTORE (HL) 
Ft 724 FOP OF 
220000 733 tD CLOWNYB). & SRESTORE (OE OOOH) 
E1 724 FU HL TRESTORE REGISTERS. 
CA 727 POP ec 
Fi ran) ror AF 
re Pa] RET 
740 8: 
74io4 
Fars ROACL ES RED CLIN ALIAS fi. PON ne: Es revTe nurs fo 
fae 4 
74a 3 
FS. 74ae READLPS REG Fuse aF tSAVE REGISTER: 
Lad 7a. PUSH Be 
i ts 7a? FISH HL 
42 Pas ute Hh. oO 
Pa var Lm tL». @ HL = MEMORY MAPPER Al 
aaunca eu tt A, (LOWNYE) FSAVE COECOUH) 
es by Le] PUSH AF : 
TE 752 tt A, HL) SSAVE CHL) 
FS TEE PLISH AF 
3EN7 754 to a. 7 
pore FES CUT (SALLIE T): A #SAVE VALUES. GF SUUINE: KEGS. 7 ANL E 
OBES 75 N A. (SDATPT) 
ay 7357 LD B.A 
TEOE 758 Lo A, OH 
EFS 759 OUT (SADDPT). A 
DEF SE 760 IN A, (SDATPT) 
aF FEA Lo Cc. A 
cs 762 PUSH BC. 
PEOT 74d Lo a. 7 tSET 10A CHANNEL TO CUTFLIT 
O3F%5 764 CUT (SADIPT). A 
EAL 76e Lo A, 40H 
| ear Fee cut (SDATPT). A 
SE CE TAT to A. CEH 
ORFS 762 OUT ({SADDPT)>, A 
ar TAS KOR a 
DIF 770 OUT CSDATPT). A 
SENS 773 uh aA = 
ROOTES 772 LD (LOWNYB), @ tRESET NYBBLE STEERING LOGIC 
JE 77% Lo A, (CHL) SREAD LSN OF DATA 
E60r 774 AND OFH 
ar 775 Lo Cc. A 
€3 776 Le HE 
JE 777 i A, (HL SREAD MSN OF DATA 
C27 77% SLA a 
C27 77= SLA a 
CB27 7eO SLA a 
CB2? v4.3) sta a 
El 7e2 OR c 
SF TEx Lo EE, A SRETURN BYTE DATA IN E 
C1 7E4 Por BC 
SEO? 78% re a. 7 tRESTORE SOUND REGS 
O2FS 7B4 CUT (SADDFT). A 
7s 7E7 SU a & 
Tar 4 78% uit (SDATFT). A 
FEOE Fee un A. EH 
Cars 7H CUT (SADDPT), A 
Ag 751 ib a € 
bare 79D CHIT CSDATFT). A 
Fi 792 FOF OF 
7? T74 Lo CHL) A SRESTORE (HL) 
FI 795 CO ar 
3200C0 THe. Li C.CWNYEOD. A SRESTORE (OEONOHD 
E1 797 Poe HL tRESTORE REGISTERS 
ci PRE Pur ac 
Fy IAs POF ar 
Ld Son RET 
EOL  ¢ 
B02 8 
BO § GET_LRANKLSTATUS CRANK! By STATUS « B. HORIZONTAL SELECT: €) 
ana ot 
0% ft 
640m Fo Ok = GETSTATLIS. PUSH aF SSAVE SAVE REGS 
Sand ps 207 FLUSH DE 
6407 7E ead LU a & 
e4ae FEFE eae cr OFEH 
6408 2826 e10 aK Z. GSLEXT SIF BAN © 254 
64K, FEFF Bis cr OFFH 
O40€ Passa S12 JK Zz. GS_HOME SIF BAN = 255 
e410 a? S12 AND a 
Oil e14 WK Z+ GSpot: TIF BANK «& © 
6412 e158 to UC, BNA SHERE IF EXP. BAN. 
Gals B16 un Ee. B 
6416 ai? CALL WAITE_BS_REG 
6ase €1€ up D. HSLULSN 
aM 619 Lo E. HS_MSN 
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é41t CALA Z e2¢ CALL READ_BS_REG SREAD HE: 


4420 7h e21 un aE 
642) OF zo CFL 
6422 aF 822 Lb CR 
6454 16a0 S24 Lo Db, STALL 
642%  1ECO 25 Lp €. $Ta_e 
6427 ChAIKG3 E26 CALL READ_BS_REG SREAD STOTUS NYBBLES 
6420 883 827 Lo BE 
6428 161D eze UR GS_EXIT 
6420 = 010000 829 GS_HOME (ay BC. 0 SRETURN O FOR HOME BANI: STATUS 
6430 181E 630 w GSLEXIT 
6432 ~DEFA 831 GS_pOcK IN A, (DKHSPT) RETURN DOCK BANK STATUS 
6424 OF @22 CPL 
ears 47 @33 ip B.A 

» GEC 624 up Cc. oO 

1810 635 Rr GS.EXIT 

64356 DEFF O44 GSLEXT IN A. (MREXPT) 
64320 Basu e37 AND 60H SCLE@R ALL BITS EXCEPT BIT 7 
642E OF 636 CPL 
bart 07 ear RLEA SPUT ACTIVE LOW BIT IN BIT ZERG 
6440 47 ean ed BL a 
644) Dera a1 IN A. CDKHSFT) 
64420 OF Gaz CPL 
6444 Een ba? ANI! 1 
6446 9 BE £44 Or BF 
£447 47 gas. lb BA 
6442 OF 10 aae Lu Ce. 0 
6460 Dt 647) GELEXTT FOF LE SRESIONS D.C 
644h Fi FAS: cg ar 
44an 0%, & RFT 


+ 
$ CE TLICHUNED (ADT: Mur macres ap 
' 
' 


3 
4 

@ ale cs © ET CHUNY PUSH ee: I AVE B 
ea aE 7 B34 Lo aH TUMUINE MUMEER a Hite 2 BITS OF 
AvOF NAO 257 to AS 8H 30 CHIFT H RIGHT S BITS 
4451 BOF $23 GOCLSHIFT SRL a 
6453 106C 39 CINZ OC SHIFT 
4433 x 360 INC A ‘CREATE MAS¥ BY ROLLING A 1 
4 ATS a? 941 LD B.A § LEFT CHUN® NUMFERe! TIMES. 
4437 OF B42 xOR a $ THE 1 COMES FROM THE CARRY 
Fat 37 843 SCF | FLAG 
A459 17 364 GCLROLL RLA 
645A TD BAS DUNZ OC ROLL 
ch ees | 366 POP BC TRESTORE BD 
4450 ca 847 RET 

869 (5 

g4o 4 

a70) 86§| )«=6GET.BANK_NUMBER (ADDR! HLt BANK_NUMBERS A) 

B71 + 

972 ~«1 
SOTE cs 73 GET.NUMEER Push BC tSAVE REGS 
oar os 874 PUSH DE 
5440 CD4De4s 375 CALL GET CHUN. 
4463 ar 374 to Cc. a 
4468 SAa1S43 877 Lp A» (BS_MAX_BANK)IGET LARGEST BANK NUMBER 
4447 A? 373 AND a 
base 2 379 JR Z» ON_RD_DOCK tIF NO EXP. BANKS 
444Q 47 $30 Lp B.A 
6463 SO 261 GN_CHECK Lo —E. B 'SEARCH ALL EXP. BANKS 
444 cnoses 382 CALL GET_STATUS 
Saar al $83 AND c 
6470 =2823 e684 UR 2, ONLEXP SFOUND THE CHUNK, SO EXIT LOOP 
6472 1077 835 DUNZ GN_CHECK ; 
4474 uBF4 836 GN-RD_DOCK IN A. (DKHSPT) tNOT IN EXP. BANKS. SO CHECK DoCcY 
6476 OF 8a7 CPL 
4477 Al ese AND c 
4a78 7ea1e se ur Z, GN_DOCK 
647A oo gon Dec c TIF CHUNK > i. THEN CAN’T BE IN EXT. 
4478 2011 S91 JR NZ. GN_HOME 
6470 BFF a92 IN A. (HREXPT) 'CHECK IF IN EXT, BANK 
$47F £680 $23 AND 80H 
4481 z7 374 Lo Oo. a 
4482 DBF4 375 IN A. (ORHSPT) 
6a34 Eso1 BPS AND 1 
6436 OF 397 RRCA 
£487 2 S98 AND iy 
2488 2804 Bre LR z+ GN_HOME tNOT IN EXT. Bane. 
448A SEFE 900 Lo Aa, OFEH TIN EXT, BANK, SO RETURN 2846 
64ec 1f0e8 Ol IR GNIEXIT 
643€ 3€FF 202 GN.HOME LO A. OF FH TIN HOME BANK. SG RETURN 255 
4490 1304 OR MR GN_LEXTT 
6492 AF 24 GNDOLE xOR a TFOUND CHUNK IN DOCK. SO RETURN « 
6493 tso1 OR ms GN. EXIT 
4495 73 904 GN_EXP Lo a B SRETURN EXP. BANK NUMBER 
4496 207 GNIEXIT POP DE tRESTORE REGS 
6497 Les | 208 POP Bc 
4493 Cc? 902 RET 

910 ft 

2 en 

912 $ BANKLENABLE (BANK! B, HORIZONTAL.SELECT? ©) 

Ft + 

914 5 
6499 FS 915 BANK_ENABLE PUSH AF SSAVE REGISTERS 
4428 cs FS PUSH BC 
6498 Hn] 917 PUSH DE 
4430 es 913 PUSH HL 
4490 4g we Lb Hy B 
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649€ 301563 920 Lo A. (ES_NAX_BANK)IOET LARGEST BANK NUMBER 


44aal ay 921 AND a 
SAAD z3il e2 JF Z. BESKIP TIF NO EXP. BANKS 
nana 14680 923 Lo Dd. BNA 
6406 1E00 924 LD €. 0 
4408 = CUSC63 225 CALL WRITE_BS_REG 
<4AB 16a0 924 Lo B. HSP 
64an FS S27 PUSH oF 
SORE 7? 928 Lo ac 
44aF oF ene CAL 
5480 2 930 uo €. a 
4481 Fi 93 PoP OF 
6482 cosce3 932 CALL WRITE_BS_REG tTURN OFF APPROPRIATE BITS OF 
93: $ ALL EXP. BANKS 
GaBS 73 934 «=BELSKIP LD a. B 
44BS AT 935 AND a 
44B7 aon 936 JA NZ. BE_NTDOCK 
445° 7? 937 Lo ac 
44BA FEFF 933 ce OF FH 
64SEC ShO4 928 ue Z, BELEXT.OK 
448E OBFF 240 IN A. (CHREXPT) (HERE FOR DOCK 
4400 CREF eal RES 7, a 
4402 O3FF 942 OUT {HREXPT). A 
sana 7% 742 BELEXT_.OK un ac 
54aCS iF 344 CPL. 
4406 O84 245 our (DKHSPT). A SENABLE DOCK 
4408 124F 7 T-) IR BE_LEXIT 
640A 73 947) BE_NTDOLK tp a. B sCHECK IF ExT. 
64c8 FEFE 948 cP OF EH 
4ach 2o10 49 i NZ. BE_LNTEXT 
o4cr ORFF IM A. (CHREXIPT) (HERE FOR EXT. 
4a 17 FLA 
4402 CBle RR ¢ 
4308 af ccr 
4405 iF PRA 
6406 OFF Cast CHREXET), a 
6403 CB7F SA BIT 7 a 
440 20nd 257 AR NZ. DE_SET 
4300 ORE 4 2 IN A. (REHSPT) 
s4D€ Oa aad ey RES mb 
64EO 03F 4 Perr wT COEHSPTD. A 
co ey rez". a1 RS REET 
€4E4 CRF 4 S62 RESET IN A, CDYHSFT) 
abe crc? 6% SET a, A 
4a@Eo wre $64 cuit (IWHSFTI. & 
GaEA hry © 68 mo BELEXIT 
AGES CRE 4 S64 BC_NTEXT IN A, (ReHSPT) COISAELE cece 
4a@€E oF 7 CPL 
eaer =F 96% ur Ee. A 
sar 678 wee uo aC 
eaFy Pa e970 CPL 
1aF> he °71 mK Ee 
4aF 2 oF o7> CPL 
sara nara O72 CAT (WHSET), A 
aaF CR4) o7a Blt oO. ¢ 
AMF 2c O75 i NZ. BELCHELHOME 
2aFa DEFF 97% IN A. (HREXPT) THISABLE EXT. 
64FC CeRF $77 RES. Fo A 
CaFE CoFF 978 our CHREXPT). A 
atu DBF ors IN A. (DAHSFT) 
e502 Cel? on RES oa, A 
roe] Lisra b= | CUT (DKHSFT). A 
Oe, 78 e282 = BE.CHt._HCME Lt Aa. B tCHEC} IF HOME 
407 FEFF ED cr OF FH 
C309 2S0E ona aK Zz. RE-EX1T 11S HOME, SO DONE 
Cea 1600 oot Le ¢ D. BNA CWRITE NEW EXP. BANE STATUS 
6300 BS Be ub Ee. B 
60E Chea? oR7 CALL WRITE_BS_REG 
Cos B | 1640 eRe Lo G,. 4S 
6242 ve Bhd ur a ¢ 
6514 OF S90 CPL 
esis OF ba | up €. a 
6516 COSCe3 oop CALL WRITE_BS_REG 
ane €1 973 «BELEXIT POF LS SRESTORE REGISTERS 
OTA Ca 94 FOr De 
a01k qi baeen) POF BC 
GEC Fl wre, POP OF 
ee9n £° on] RET 
on 
wou 
1000 § SAVELBANSTATUSES (STATUTLADDR: 1X) 
1001 4 
nea 4 PUSHES THE STATUS GF ALL BANKS ON THE STACK 
1002 
1004 ot 
Fe 100% SAVE_STATLUK. FISH OF tSAVE REGS 
ce Ine PUSH 4 
tres 1007 FALCSH te 
DBFF A tole: IN A. CHREXKET) 'SAVE EXT. BAM. STATIT: 
an PCs Nee SLEAVE FITS 0-6 ALONE' NOES FUT IN 
oo Init Nee $ TG rEEF ALNRS THE SAME 
DLT Pee 07) Lu (1K), A 
OD2> 1o12 INC x 
UBF @ iis IN fi. (DKHSPT) +GET DOCK BANK STATUS 
DDT 700 1014 Lo CIXD. A 
0 Ong) sols INC Ix 
IAIN 10s 1a A. (BS_MAX_BANKDIGET NUMBER OF BANS 
a7 1017 anti a 
2600 1018 JR Ze SGLEXIT 
a? 1016 un B.A ¢SET UF COLINTERK 
sa 1020 $S_LOOP to €&. 8 TBANK NUMBER INTO E 
chnos.4 1021 CALL GET_STATUS 1GET Bare STATUS OF BAN 6B 


43 BU7 190 un (Ix). ¢ 
CS RF poss INC ux 
4341 a3 to . € 
Ct Pd 10F 4 EINZ SS.LOOPF $00 FOR ALL 
6544. DD26 SS_ExIT cec ix 
65486 bo ror ve SRESTORE REGS 
6347 C1 FOP oc 
ET4E Fi FOr wr 
e549 co RET 
t 
1 
1 RESTORE. BANK_STATUSES (STATUS_ADDRI 1X) 
5 
] RESTORES BANK STATUS TO ALL BANKS 
4 
‘ 
6348 FS. RESTORE.STATUS PUSH ar 'SAVE REGS 
6348 cs PUSH ec 
654C ws PUSM OE 
6340 DD7EUO LD a (1x) tOET EXT. ROM STATUS 
ETO OFF Gur CHREXPT). A 
6352 Ob2 INC ux 
6334 DUTEOR up Aa IX) SGET DOCK BANK STATUS 
6357 [ik OUT (DKHSPT). A 
6559 Dr23 Inc 1x 
€35B6 941363 Lo A. (BS_MAX_BANKIIGET NUMBER OF BANKS 
eS5€ a? Ont a 
ose 2008 MR 2, RSEXIT 
6361 47 up BA tSET UF COUNTER 
562 DD4ENR RS.LOOF up Cc. «rx 
6545 CIe7E4 CALL BANK ENABLE SWRITE BARH STATUS CF BAND @F 
6566 D023 INC ix 
$54R 10F 6 DUN? RS. LOCP DO FOR ALL 
ESOC OucB RSEXIT oEC Ix 
654E i) POF tf SRESTORE REGS 
Mor Co | POF BC 
6570 Fs Late ar 
€373 cy KET 
' 
‘ 
§ GOTO_LBAN (bata. HORIZONTAL SELECT. ADLIAS F GEE CN STAD 
: 
‘ 
t SETS UR THE PESTINAT ICO Bite ANLD SUMED WITH RET Ter allie oo. 
t IN BANE. 
8 
H 
A eg OS QUT, BANE Lb Ix. TET IX To Le 
bop? ALD Ix. SP 
CF te tl (9x), € $3AVE BE AND TRATH RET amir 
072001 Lt (Ixe13. & 
WOdEr tb Ce. ¢baer) {HET FARM: FOR BANK. ENABLE 
er PAR) to B. (ikea) 
CHO7Ke Chak BANK ENABLE 
C1 PoP BC SRESTORE BC 
DUE Fir ™ TTRAGH FARMS TO OTC _LLANE 
ObEL POP 1x tGET ADDR 
UnEe> TX ad (1x) 
: 
' 
+ CALLIBANE (ADDR, BANK. HORIZONTAL_SELECT. PRMLOUT, FRM_IM) 
t ALL INPUT FARAMETERS ARE PUSHED ON THE STACK 
eh 8 
1035 § ‘CLOMBERS IX 
1094 6 
Loe? 8 
1omn ft SETS UP THE BANK AND MAKES A JUMP WITH RETURN ADDRESS TO ADDRESS 
193% 8 IN BANK, 
10m 6 
ww. 8 
1092 BSLSTACK DEFS 64 
1073 BS.SP DEFS 2 
iowa 6 
reas s 
oti E3 19096 CALL BANK Ex (SP). HL 1GET RET AGDR 
roel oF | DUZACESS 1097 Lo IX, (BOSP) 
4905 DDIB 1696 rec Xx 
4507 DB7400 1999 up (IX). H 
Seo fo ODS 1100 vec Ix 
Cot GO7 Si) 1101 Lo (IX), b SPUSH HL ON BS.STACK 
raed to ei 119s FOP HL 
TEGO E3 1103 ex (SP), HL 1GET PRM_IN 
TE. 8 ON2B $104 DEC 1x 
45€3 DD7400 1105 Lo (Ix), W 
&5E6 ODE 1106 bec ix 
STE3 007300 1107 LD CIXee & 3PUSH PRILIN ON BS_STACK 
47€B DU2ZICESS 11068 LD (BS.SP). IX SUPDATE &S_SP 
SSEF os 1109 PUSH te SSAVE REGS 
6TFQ cs 1110 PUSH ec 
OFFI FS inl PUSH od 
CHF2 210000 1112 LO HL» 0 
45FS 39 1113 ADD HL, SP SH. = SP 
45F6 4 1114 Lu DB. HW 
43F7 so a1is Lo Eeu 
$5F3 2ALS463 1116 uo A. (BS_MAX_ BANK) 
StF aF 4117 Lo fC. A 
elec 9600 1113 Ly BRB. oO 
é5FE O3 1119 INC Bet 
SFr 3 itae inc BC 380 = MAX GAM + o 
bens a7 aici ANU a 


4601 E42 btl2 spc HL. 8 


6603 FO 4123 LD SP. HL 
6408 DN? 1 OOOO 1124 LO Ix, a 
4608 oo17 1125 ADO . Ix. DE 
660A EB 1126 ex DE. : SDE. HL NOW CONTAIN DEST. Rt 
1227 3 POINTERS FOR A BLOCK MOVE 
4408 On4eoa 1128 LD Ce. (CIX+FRM_OUT) 
60€ 04408 212° Leu B. (ExXePRM_OUT) 
als SEOE 11230 Lo A 14 
6613 31 1131 AaDD a ¢ 
eata aF 1422 tb Cc. A 
4O15 3001 1133 IR NC. CB.NC1 3BC = PRM_OUT + 14 
tal? ic 1124 Inc B s 
6619 EDBO 1138 CBLNC1 LDIR tMAKE ROOM FOR BANK STATIS 
661A BS 11346 PUSH DE 
éoiB ODE’ 1237 PoP Ix six = DE 
4610 COLESS 1128 CALL SAVE_STATUS 
4420) aD210000 1139 Lo rx, 0 
6424 nD39 114g ADO IX, SP 
4626 OD4EOA 1141 LD C. (IX+HOR.SEL) 1GCT PARMNS FOR BANK_ENABLE 
429 Do4ecB 1242 Lb Be CIX+BANK) 
4420 COVISS 1143 CALL BANK ENABLE TENABLE DESTINATION BANT 
bALF Fi 1144 POP AF (RESTORE REGS 
6630 «01 1143 PoP BC 
6651 O01 1146 Por DE 
6622 «E1 1147 PoP He 
4533 ODE1 1143 Por {x S TRASH PARMS TO CALL_BANK AND GET ADDR 
46353 Opel 1149 POP Ix 
6637 ODE1 1130 Por 1x 
6639 coaces 1151 CALL JP IX SCALL ADDRESS IN IX 
4630 FS 1152 PUSH a tSAVE REGS. : 
6630 CS 1253 PUSH ac 
46638 os 1134 PUSH ce 
663F ES 1155 PUSH a 
S580 OUZACES® 1134 LD 1X, (BS_SP) 
4644 OD4ECw) 1157 up Cc. ¢1x) 
4447 obo3 1153 INC Ix 
4649 0n4600 1159 Lo B. (EX) 
4464C 0023 1160 INC Ix tPOP PRMLIN OFF BS_STACK 
4oa€ fo22ce45 1161 Lo {OS_SP). 1X tUPDATE BS_sP 
$452 Dtr2tooug 1142 LD Ix. oO 
46546 no39 1143 ano xk. SP 
6459 SEU 1144 LD a. 8 
465R 3t 1145 anD ac 
6633 aF 1146 LD ce A 
46350 3001 1147 IR NC. CB.NC2 +BC «© PRHLIN + 3 
SAE om 1148 INC & 
665F belaen) 1149 CBLNCS and TX. BC VIX = SP + PRALIN + 3 
taal ODES 1170 PUSH Ix 
64463 Et 1171 POF He ‘ML = IX 
BLE4 <8 1172 Cec HL fe CRC FOINTER Form FLUE MOVE 
$065 CO4AaA45 1173 Cale RESTORE 2TAMES SRESTORE STATIN. OF ALL BANE” 
LAB LOES 1174 Pur ry 
b44Q 01 1t75 rg ic} TOR = DET PORE Fete Guile et 
66-65 ERS 1176 CRA TOEALLOCATE SFACE FOR BAN ¢TATIIS. 
eeodD ee 21177 ex DE. WL 
eO6E as 117% INT Hu 
OO6F FO ays Lo oF. HL IRESTORE SF 
O70) NUZACESS 130 Lt IX. (CES.SF) 
6674 POAE cn 1181 to Cc. «mx 
6477 Obl2s Ales Ine Ix 
6479 004 6.00 1363 ur B. 41x) 
6676 Onas 1164 INC Ix SFOP RET ADDR CFF BS_STACI. 
NoseceEss 1125 Lo (BS_SF), IX SLFDATE Bo.SF 
Ce 1164. PUSH i 
ODE 1187 PCE Ix 
Et 1186 POF HL tRESTORE REGS 
isp} 1129 Por DE 
ci 1190 FCF we. 
Fi 119) POF ar 
DDE. {192 PUSH Ix SPUT RET ALI ON STACK 
cy 1193 RET 
y1946 3 
iiss 5 
1196 4§ «HERE ARE SOME EQUATES WHICH ARE USED BY XFER.BYTES ANI! THE ROLITINES IT 
1197 «+ )~ «6CALLS. 
ive ¢ 
119% DIRECTION Eou o 
1200 BUF _PTR Eo o 
1201) LENGTH Ew 2 
1202 DEST_ADDR Eou 4 
1203 SkCLADDIR Equ & 
1204 DEST_BAN: Eou 8 
1205 SRC RANE EQu 9 
woe ft 
azo7 ot 
1206 § MOVE_BYTES (BYTES. TO_MOVE! DE, DIRECTION ¢ A) 
1209 + 
W100 oft 
66S: Es 1211 MOVE_BYTES: FAH He SSAVE KEGISTERS 
6630 oS 2212 PUSH DE . 
6688 cs 1233 PUSH ia 
663F ac 1214 Lo c. B 
66 Date 1215 Lp B, (1X+SRC_BAN) 
6673 CcOV944 216 CALL RANt ENABLE tSELECT Shc BAN. 
6696 42 1217 Lu BB ob tMOVE FROM SKC TO STACK. 
6697 45 1218 tl Ge 
64.93 DESEO 1219 Lb E. (IX+RF PTR) 
6698 DOTSEO1 1220 LD G. CIX+BUF_PTRe1) 
6O47E DICE CS i221 Lio CL. C1XeSkC_ADDR) 
66A1 006607 222 Lo HW. CIX*SRC_ADIRG)) 
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ana Sans 


Pree ee Pees 


Q7 
OF 


Beat 


ELE 


an 
1205 
EDEE 
a7 
Epa: 
DD7 SG 
DD7 407 
C1 

—) 

Es 

cs 
pnaeoe 
CUv964 
a4 

4b 
DUSE C4 
DDI405 
DDOE OG 
DDE601 
o7 

OF 
Seok. 
EDR 
oF 
1805 
EDBE 
a7 
ED42 
OD7S504 
DD7 405. 


™ 
So 
(Daeeaz 
DU46c3 
DN7EGO 
O7 

OF 

Ko Te 
ay 
LEO? 
Eas 
Craps 


11oAn 
1 a 


Eb 


RRA 
i C. MELRVI TIF ACO 
LOTR 
ADI! HE. EC SINGCREMENT FOINTER 
if MBL 
Mb_RVI Lik 
AND a 
SBC HM. BC SDECREMENT FOINTER 
BLUE Li CIX*¢SRCLADDR). & sSTQRE NEW POINTER VALUE 
Lo tIX*SRC_ADDR+1). H 
PCF BC 
POF Hw 
PUSH Mw 
PUSH ec 
Lo B. CIX+DEST_BANM:) 
CALL BAN ENABLE tSELECT DEST BAN. 
Lb B. H SMCIVVE FROM STACI. TO DEST 
LG cL 
1 a) E, ¢1X+DEST_ADDR) 
ip B. CIX*DEST_ADDR+1) 
Lb LL, (IX*BUF_PTR) 
up H. CIX¢BUF PTROI) 
RLCA 
RATA 
KR C. MB_RV2 tIF ACG 
LDIR 
adn HL. BC TINCREMENT POINTER 
WR MB_UP2 
MB_RV2 LDDRK 
AND a 
Sec ML, BC *DECREMENT POINTER 
MELUFS tp CEX*DEST_ADOR), Lo 8tSTORE NEW POINTER VALUE 
Lu CIXeDEST_ADDR+1). H 
POP ec IRESTORE REGISTERS 
POF cE 
POP HL 
RET 
' 
’ 
1 CREATE_LBITMAF (ADD: HLS BITMAF: A) 
‘ 
' 
CREATE_BITMAF Lt BD. oH tSAVE START ADDR 
ub E~t 
un CG. CIX*LENGTH) 
LD B, CIXeLENGTHe1) 
Lo A, CIX*+DIRECTIOND 
RLCA SCALCULATE END ADDK 
RRCA 
ay Cc. CBSUB tif aco 
arp HL. EC 
raid CE_CONT 
CRLSUE SHC HL, EC 
CELCONT CALL GET_CHLUINE sGET END CHUN BIT 
CPL 
Lo BA 
Ex LE. HL 
CALL (SE T_LCHIINE, tGET START CHUN BIT 
CPL 
me A t. A 
xO Es 
A 2. CRLEXIT 
uo at SHERE IF START AND ENC CHUN SL 
ANE! i) + ARE NUT THE ZAME 
Lu H. A SPUT START ANDI END FITS TOGETHER ANE 
Lan Ce 0 + FILL IN BTEWEEN THEM WITH ZERUES 
SCF 
CE_NB1 Lo a. B tTEST NEXT BIT 
RL v 
ANI! c 
al NZ, CHONE! TCTHERWIGE. FOLINGD FIRST ZER0 
CBLNBS Lo A.B tTEST NEXT BIT 
Ru ¢ 
AND De 
IR Z. CBLEXIT tFrHIND LAST ZERG 
xOR 8 SOTHERWI'SE. UPDATE BITMAP 
Lo BH A 
JR CB_NB2 
CBLEXIT uo a. B tTRETURN BITMAP 
RET 
' 
3 
3 XFER_LBYTES (DIRECTION, LENGTH. DEST_LAGOR, SRC_LADIR, LEST BANK, 
3 SRCLBANK! PASSED ON STACK IN ORDER SHOWNG STATLIS_CUDE! AD 
$ 
% ALL PARAMETERS ON STACK HAVE OFFSETS DEFINED ABOVE. 
' 
, 
XFER_BYTES PUSH AF 'SAVE REGS 
PLUSH Bc 
FAISH te 
PLSh HL 
Lo HL, Oo 
ADD HL, SP 
Lo UE. 10 
ano HL. DE 
ex CE. HL tHE POINTS TO START OF FARMS 
LD A. CBS_MAXLBANM) 


ar 
O600 


2bowod 
3? 


ns 


47 
OD7EG? 
NNS3403 


DNTEOO 
DOT SCH) 
On74aO1 
DUSEG? 
DUSEOS 
7 
Ens. 
S08 
COACES 


BSE ck) 
ULAO01 

19 

Fo 

OF 

DL21 0000 
Ot3> 
Ch4ac8. 


X8_DIFF._ BANKS 


XB_REVERSE 
XB.CVERLAP 


XE_ SPACE 


XE_MOVE_LOOF 


XE_LAST MOVE 


XBLEXIT 


Me tHL = SP - MAX_BANK - < 


IX TIX POINTS TO LOCATION FO SAVE FTATIS 
SF. EX 
TAVE_STATUS 1SAVE BANM.S’ STATUS 


Ix TTX ra POINTS TO C ARM: 

L. CPSC LAL 

He C1¥e skh ADoRe1) 

CREATE.BITMAP $GET SRC BITMAP 

or 3SAVE ON STACK TEMPORARILY 
L. (IX+DEST_ADDR) 

4. CIX+DEST_ADOR+1) 

CREATE_BITMAP tOET CEST BITMAP 


Ce a sC = DEST BITMAP 
ar 
8. A 5B © SRC BITMAP 


A. (CIX+SRC_BANK) 
O. (IX+DEST_BANK) 


1) SCOMPARE SRC AND DEST BANK NUMBERS 
NZ. XB_DIFF_ BANKS 

a B SHERE IF BANK NUMBERS ARE DIFFERENT 
c 

8. A $B © UNION OR SRC AND DEST BITHAFS 
XB_DO_NOVE 

a B *SCHECK FOR OVERLAP BETWEEN SRC ANL 
c 8 DEST CHUNKS 

OFF 

NZ. XB_OVERLAP 

e. B tHERE IF WO OVERLAP 

B. OD 

BANK_ENABLE 'SELECT DEST BANK 

B. (IX+SRC_BANK) 

GE 

BANK_ENABLE SSELECT SRC SANK 


L+ (1X+SRC_ADDR) 

H. (1X+SRC_ADDR+1) 
E. (IX+DEST_ADDR> 
D. CIX*+DESTADDR+1) 
Ce CEX*LENGTH) 

B. CIX*LENOTHS!) 

A. CIX*DIRECTION) 


C: XB_REVERSE IF ACO 
xB.EXIT 


XB_EXIT 
HL,» MSTBOT 


HL, DE {HL = ADLRESS OF STATE LIMIT 
DE. FREELRYTES 

tL, DE 

DE. He SDE = SP_NEW 

HL. 

HL. SP SHO ow tlk 

oe TOLMPORE SP lULE METH OP 


Ho. DE 

NC. KE_LSPALE vIF SF_LOLI - SF_LNEW > © 
ai TRETURN ERROR CODE 
XBLEXIT 

DE 

Te. MM 

SP. HL SSET SF TO SF_LNEW 

De SCE = BL _LSZ 

A. CIN+DIRECTION) tH © ELIF_PTR 

CIUX¢RUF PTR), Lb (SAVE BUF LFTR ON STACT 
CIX¢BUF LPTR41). H 

Le CIX+LENGTH) 

H. CIX*LENGTH+1) 

a sHL = BYTES LEFT TO) mie 
HL. DE (DE = BYTES TC MOVE THIS TIME 
C. KELLAST_MOVE 8 IF LESS THAN BUF_S2 BYTES. LEFT 
MOVE BYTES 

XB _KWE_LOGP 

HL. DE 

DE, WL 

MOVE _BYTES 

DE, HL 

i+ CIx+BUF_PTR) 

AH, CIX+BUF_PTRe1) 


HL. DE SH © RUF LPTRER SZ 

SP. HL SRESTORE STACI. FOINTER 

a SRETURN COLE FOR SUCCESSFUL COMFLETIUN 
Ix. 0 

1X, SP 


RESTORE_STATUS 8RECTORE STATE AND RETURN ZERO COLE 


425% 
6e17 
4816 
681A 
681C 
OSiE 
6520 
6822 
6€23 


1D 


LE 
MMs 
104 
THOS 


ADH 
1BOA 
1DOC 
IDOE 
IDG 


m2 
1014 
Ips 
1013 
IDA 


Tac 
1M 
bee 
Wess 
Ins4 


Dae 
IDs 


1n2A 


pa UPS 
102E 
13 


OB! COME M STMT SOURCE STATEMENT 


1423 
1424 
1425 
1426 
1427 
1428 
1429 
3430 
1431 
14az2 
1433 
1434 
1435 
1436 
1437 
144g 
1439 
1440 
1441 
14482 
1443 
1444 
1445 
1446 
1447 
1448 
144¢ 
1450 
1431 
1432 
1433 
1454 


DON PS A eure 


MQTOle rT 


FIXTSLe 


bgteatrH 

INT 

GET _WORD 

FltT WORD 

GET _LETATUS 

GET _ NUMBER 

BAN). _ENABLE 
SAVE_STATLIS 
RESTORE STATUS 
BS_STACK 

BSL SE 


MOVE_BYTES 
CREATE_BITMAF 
XFER_BYTES 


$ HERE IS THE FIXUP TABLE FOR THE VIDEC! MCE CHANGER, 


GOIQLEXT_LINIT CALE: 


Ect 
EcHt 
EU 
Era 
Ect 
eau 
eeu 
E@u 
Bou 
Een 
Cis 
Eau 
Eun 
Eau 
EGH) 
Eau 


Hu) 


iy 

OF 

@> (HREXFT) 
7, @ 
CAREXPT). A 
ai 
(DKHSPT). A 
AF 

(HL) 


aH 
&2AEH 
43146H 
6232BH 
6405H 
&45EH 
647 9H 
6S1EH 
654AH 
653EH 
éS5CEH 
6572H 
65004 
648CH 
66ESH 
$722H 


tRESTORE REGS 


CLEAN UF PARMS 


TIRADH ELE sabia 


ASM 5.9 


IT DEFINES. THE 


$ LOCATIONS IN RAM WHICH MUST BE UPDATED WHEN MOVED FROM CHUNE. 32 TO CHUN 7 


$ OR V CE-VERSA, 


FIXTBtL 


ORG 


DEFW 
DEFW 
DEFW 
DEFW 


DEFW 
DEFW 
DEFW 
DEFW 
DEFW 


Deru 
DEFW 
DEFW 
DEFW 
DEF W 


DEF W 
Der 
DEFW 
DEFW 
DEFW 


terw 
DEF W 
DEFW 


LeFw 


UF iW 
Wer 
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ILOOH 


DISPATCH+32ZH 
CISPATCH+4DH 
DISFATCH+7 2H 
DISFATCH+OARH 


INT+0AH 
INT+IFH 
INT+25H 
INT+2EH 
INT+40H 


GET_WORL+4H 

GET_WORD+0AH 
GET WORD+OEH 
GET_WORD+ 14H 
GET_WORD+1FH 


FUT _WORT+ 3H 
FUT_WORD+9H 
FUT _WORD+ODH 
PUT _WORD+ 13H 
FUT WORD 1CH 


GETLSTATUS+ 1 oH 
GE TUSTATIS+ 19H 
GET LSTATUS+2 3H 


OE NEE 4 SH 
3E [_IAIMBE + bt 
CET MOMEE ert 


THE AUURESSES IN THE TABLE ARE DEFINED AS CHUN: 3 ADDRESSES 


1D36 
1038 
IDSA 


1D 
1DS€ 


1n40 
1042 


1a 
tors 


104% 
104A 
1bac 
1D4E 
IDs 
1S 
1ps4 
ins4 
IDSs 
105A 
105¢ 


1DSE 
IDéa 


ites 
10464 


D464 
1045 
IDGA 
IDec 
IDéE 
1D76 
AD72 
1074 
1E76 
1O7& 


1pD7A 


Grae 
SOG. 
SE66 
7264 
EM 


SAGE 
COE 


FLG& 
O267 


2047 
4aF47 
HI67 
SAG7 
7667 
7067 
A767 
TH? 
E367 
Fos? 


OOO 


APPENDIX B 


terw 
OEFU 
DEFW 


DEFW 
DEFW 


LEFW 
DEFW 


DEFW 
DEFW 


DEFW 
DEFW 
DFW 
DEF 
vEFW 
DEFW 
DEFW 
DEFW 
DEFW 
REFW 
DEFW 


DEFW 
DEFW 


Tera 
OEFW 


DEFW 
DEFW 
DeFW 
tEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 


DEFW 


BANK ENABLE +1 AH 
BAN. ENABLE +75H 
BAN. ENABLE +7DH 


SAVE_STATUS+14H 
SAVE_STATUS+ICH 


RESTORE STATUS+ 12H 
RES TORE_STATUS+1CH 


BS_SP 
GOTO. BANK+13H 


MOVE_BYTES+8H 
MOVE_BYTES+34H 


CREATE_BI TMAP+ 15H 
CREATE_BI TMAP+ 1 BH 


XFER_BYTES+0EH 
XFER..BYTES+20H 
XFER_BYTES+2EH 
XFER_BYTES+30H 
XFER_BYTES+54H 
XFER_BYTES+S8H 
XFER_BYTES+65H 
XFER_BYTES+0BAH 
XFER_BYTES+0C1H 
XFER_BYTES+OD4H 


Qa STHIS IS THE TABLE TERMINATOR 


System Variables Definition File 


TS2000 HOME ROM 
“ORJ CODE M STMT “SOURCE “STATEMENT 


Loc 


2068 HOME ROM 


ASH 5.9 


BASIC 
EJECT 
# INCL. SYSVAR 
*#PAGESIZE 54 
RSTs MACRO #ROUT 
RST #ROUT 
ENDM 
ASSERT! MACRO @COND 
COND .NOT. (#COND) 
ERROR IN ASSERTION #COND 
ENDC 
ENDM 


$ SYSTEM VARIABLES 


L_LEN 
TV.LNS# 
D.FILEs 
ATTRS: 
PRBUFF t 


EQU 32 
EQU 24 
EQU 4000H 


EQU D_FILE+L_LEN#TV_LNS#S 
EQU ATTRS+TV_LNS#L.LEN 


$ @ CHARS PER LINE ON THE DISPLAY 


$ NO. 


OF LINES ON TV SCREEN 


* ADDRESS OF DISPLAY FILE 


* SCREEN ATTRIBUTES 
{ PRINTER BUFFER 


ASSERT PRBUFF. AND. OFFH=0 
COND .NOT. (PRBUFF. AND. OFFH=0) 
ERROR IN ASSERTION PRBUFF.AND. OFFH=0 


ENDC 
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35 4 KSTATE: EQU PRBUFF+L_LENSS + SEE KB DOCUMENTATION 

36 KS.Ar EQU 0 $ 1ST BYTE IS A CHAR KEY PRESSED 

37 KS.Cct EQU 1 ‘ 2ND IS TIME TILL COUNTS AS RELEASED 

38 KS_B: EQU 2 SRD IS TIME (IN FRAMES) TILL REPEAT 

39 KS_Dt EQU 3 4TH IS CODE WHEN REPEATS. 
STH - 6TH ARE A SECOND SET OF 1ST FOUR 

NEWLY PRESSED KEY 

DELAY BEFORE 1ST REPEAT (INITIALIZED TO 35) 

DELAY BEFORE SUBSEQUENT REPEATS (INITIALIZED TO 5) 

—> CHAR AFTER “(° IN FORMAL PARAMETER LIST: MUST BE 
O WHEN NO USER-DEFINED FN BEING EVALUATED 

DATA BYTE IN COMPOSITE CHAR FROM KEYBOARD 

USED FOR STORING BYTES IN COMPOSITE CHARACTERS: 
(TVDATA) @ KEY BYTE... 
(TVDATA4+1) = 1ST DATA BYTE FOR AT OR TAB. 

STREAM DATA: POINTERS (OFFSETS FROM (CHANS)-1) TO 


41 LAST_K! EQU KSTATE+6 
42 REPDEL! EQU LAST_K+1 
43 REPPER! EQU REPDEL+1 
44 DEFADD: EQU REPPER+1 


46 K.DATAt EQU DEFADD+2 
47 TVDATAt EQU K_DATA+I 


SO STRMS! EQU TVDATA+2 


2 | CHANNELS. O = STREAM NOT OPEN. 
S32 HIDSTRIEQU 3 NO. STREAMS HIDDEN FROM USER. THESE ARE TIED 
$3 -UNALTERABLY TO SPECIFIC CHANNELS. 


. KEYBOARD 

TV, UPPER HALF OF SCREEN 
INSERTION IN RAM 
STREAM_FOR COMMANDS 
STREAM FOR INPUT DATA 


54 HID_Kt EQU ~3 
55 HID.S: EQU -2 
56 HIDLR: EQu -1 
37 COM_STSEQU 0 

38 INP_STSEQU 1 

59 PR.STs EQU 2 

60 .LPRUSTSEQuU 3 

61) CHARS: EQU STRMS+(HIDSTR+16)#2 : -> 8#20H BYTES BEFORE CHARACTER SET 

62 FART: EQU CHARS+2 NO. CYCLES OF ERROR NOISE (2 8VES BELOW MIDDLE C) 

63 PIP: EQU FART+1 NO. CYCLES OF KEYBOARD NOISE (3 SVES ABOVE MIDDLE C) 


$ 
§ 
64 = Y3 EQU PIP+1 t+ VALUE ALWAYS HELD IN IY 
$ 
3 


. 
6 
0 OR WE wt GE Oe OS OR OD UE OF CO Oe on on ot oe wn we mt on wn os 


65 ERR_NR EQU Y CRUN TIME ERROR #] - 1 
66 FLAGS: EQU ERR_NR+t VARIOUS FLAGS 

67 SPC: EQu 
68 PR: EQU 
69 LMODE1:EQu 
70 LMODE: EQU 
71 KEYVHITs EQu 
72 NOs: EQU 
73 INTPT: EQu 
74 TVFLAG: EQU 
J5 LHS: EQu. 
76 EDIT: EQU 
77 ECHREQ: EQU 
78 LIST: EQU 
79 CLHS: EQU 
80 ERR_SP: EGU TVFLAG+I 
61 LISTSP: EQU ERR_SP+2 
82 MODE: EQU LISTSP+2 
83 NEWPPC: EQU MODE+1 
84 NSPPC: EQU NEWPPC+2 


SUPPRESS SPACE BEFORE TOKENS 
PRINTING TO PRINTER, NOT TV 
L MODE. NOT K» AT CURRENT CHARACTER 
L MODE. NOT K. AT CURSOR 
KEYHIT FOUND 
EXPRESSION IS NUMERICAL. NOT STRING 
REQ INTERPRET RATHER THAN CHECK SYNTAX 
FLAGS ASSOCIATED WITH THE Tv 
PRINTING TO. LOWER HALF OF SCREEN. 
OUTPUTTING LINE FOR EDIT OR NO. FOR STRING 
ECHO REQUESTED IF INPUTTING FROM KEYBOARD 
OUTPUTTING AN AUTOMATIC LISTING 
CLEAR LGWER HALF WHEN KEY PRESSED 
-> BOTTOM ITEM ON MACHINE STACK. 
-> RETURN ADDRESS FROM AUTOMATIC LISTING 
Ow K ORL. 1" F, 2G. 
LINE TO BE JUMPED TO 
SUBLINE TO BE JUMPED TO (BIT 7 OFF FORCES JUMP) 


CAaAWdNK Oo 


LAGS+1 


Aewoewonn 


85 PPC EQU NSPPC+1 LINE # OF INSTR BEING INTERPRETED 

87 BORDCR: EQU SUBPPC+1 BORDER COLOUR (SHIFTED LEFT BACKG BITS WITH OS IN 
838 BITS 0-2 & 6-7) 

89 E_PPC EQU BORDCR+1 LINE @ OF “CURRENT” LINE IN LISTING 

90 THE VARIABLES FROM (VARS) UP TO & INCLUDING (STKEND) 
v1 ARE “MOVABLE” IN THE SENSE THAT THEY ARE ADJUSTED 


(BY REMGSZ IN MODULE EDIT) WHENEVER STUFF IS 
-INSERTED IN OR DELETED FROM RAM. 
-> 1ST RECORD FOR A VARIABLE (LAST IS 1 BYTE 80H) 
-> VAR MATCHED BY TEMPL CODE 1 OR 4 (TEXT OR RECORD) 
—> CHANNEL DATA (INCLUDING FLOPPY BUFFERS). 


94 VARS EQU E_PPC+2 
95 DEST EQU VARS+2 
96 CHANS.: EQU DEST+2 


97 EACH ITEM COMPRISES: 

98 THE ADDRESS OF AN OUTPUT ROUTINE FOR WRCH, 
99 THE ADDRESS OF AN INPUT ROUTINE FOR INCH, 
100 A 1-BYTE CODE FOR THE DEVICE TYPE, 


& WHERE APPROPRIATE. A FILE NAME, ADDITIONAL 
DATA & A BUFFER. 

-> DATA FOR CURRENT CHANNEL 

-> BASIC PROGRAM 

=2-NEXT LINE. OF SOURCE CODE 


102 
103. CURCHL: EQU CHANS_+2 
104 PROG: EQU CURCHL+2 


$ 
$ 
3 
s 
8 
: 
‘ 
' 
‘ 
s 
' 
$ 
5 
3 
iY 
3 
5 
’ 
8 
86 SUBPPC: EQU PPC+2 3 NO. WITHIN LINE OF INSTR BEING INTERPRETED 
% 
§ 
8 
t 
§ 
3 
‘ 
' 
5 
3 
$ 
’ 
t 
‘ 
' 
t 
; 
’ 
105._NXTLIN2_EQU_ PROG+2 8 
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DATADD: 
E_LINE 
KCUR: 
CH_ADD 
X_PTR 


WORKSPs 
STKBOTs 
STKNXT: 
STKEND: 


BREG: 
MEM: 
FLAGS2: EQU 
ALOS: EQU 
PRLEFT: EQU 
LUSTR: EQU 
CAPS_L* EQU 
RETPOS: EQU 
DELREP: EQu 
DF ..SZ Eau 
STOP EQu 
OLDPPC EQuU 
CSPPC: EQU 
FLAGX: EQU 
FLEX: Eau 
UNFND: EQU 
INPLN: EQUI 
sNQs EQu 
LINPLN: EQu 
STRLEN: EQU 
T_.ADDR EQU 
SEED EQu 
FRAMES: EQU 
FRAME2: EQU 
UDG: EQU 
COORDS: EQU 


EGU 
EQU 


P.POSNt EQU 
PR.CC: EQU 
ECHO_E: Eau 
DF_CC.... EQU 
DOFCCL: Eau 
S.POSN EQU 


. SPOSNL: EQU 


SCR.CT: EQU 

ATTR_P: EQU 

_FFOREG: EQu 
BLUE: EQU 
RED: EQU 
.GREEN: 
BACKG: EQU 
BLUEBr 


NXTLIN#2 
DATADD+2 


E_-LINE+2 


K_CUR+2 
CH_ADD+2 


X_PTR+2 
WORKSP+2 
STKBOT+2 
STKNXT 


STKENDt+2 


BREG+1 
MEM+2 


USlAn~o 


FLAGS2+1 
DF __SZ+1 
S_TOP4+2 
OLDPPC+2 
OSPPC+1 


NO A= oO 


FLAGX+1 
STRLEN+2 
T_ADDR+2 
SEED+2 
FRAMES+2 
FRAME2+1 
UDG+2 


COORDS+2 
P_POSN+1 
PR_CC+2 
ECHO_E+2 
OF CC +2 
DFCCL+2 
S.POSN+2 
SPOSNL+2 
SCR_CT+1 
0 

° 

1 

EQu 2 

3 


EQU 3 


.. REDE? __. EQU 4 

GREENB: EQU 5 
MILITEs EQu 6 
. FLASH? EQU 7 


MASK_P!® EQU 


ATTRIT: _EQu 
MASK_T: EQU 
PFLAG: EQU 


XOR_CH: EQU 
INV_CH: EQU 
FLWCB: EQU 
B.CF: EQU 
MEMBOT: EQU 
NMIADD? EQU 
RAMTOP: EQU 
P_RAMT: EQU 


ATTR_P+1 


MASK_P+1 
ATTR_T+1 
MASK_T+1 


ce) 
2 
4 


6 
P_FLAG+1 
MEMBOT+30 
NMIADD+2 
RAMTOP +2 


A WR Wl OO OE OE OO WE CD C8 On Wh OF OE OS WE Se wh OS oe YE wn 38 OS OD OF OS OU WE OS OF we en eS we we ee we 


TERMINATOR OF LAST DATA ITEM 

LINE BEING EDITED 

CURRENT. CHAR. IN INPUT BUFFER 

CURRENT CHAR WHEN SYNTAX CHECKING ETC 

1ST CHAR NOT SYNTACTICALLY OK (0 IF ALL OK) 
ALSO STORES (CHADD) DURING.READ & INPUT 
TEMPORARY WORK SPACE 

BOTTOM OF CALCULATOR STACK 

NEXT FREE PLACE ON CALCULATOR STACK 
ALTERNATIVE NAME 


KEEPS VALUE OF CALCULATOR B REGISTER 


“-> AREA USED BY CALCTR INSTRS MEMORY & COPY 
MORE FLAGS 
AUTOMATIC LISTING ON SCREEN 
PRINTER BUFFER NOT EMPTY 
INSIDE STRING WHEN DOING KB MODE IN LISTCH 
CAPITALS SHIFT LOCK ON 
RETYPE POSSIBLE AFTER SYNTAX ERROR 
DELETE KEY REPEAT (KEY HELD DOWN) 
®@ LINES IN 2ND HALF OF SCREEN INC SEP’G BLANK LINE 
LINE # CIN PROGRAM) OF TOP LINE ON SCREEN 
LINE @ OF E.G. INTERRUPTED STMT 
(OLD SUB PPC) STATEMENT NO. WITHIN LINE FOR OLDPPC 
FLAGS ASSOCIATED WITH ASSIGNMENT 
FLEXIBLE LENGTH ASSIGNMENT REQUIRED 
DESTINATION OF ASSIGNMENT NOT FOUND 
REG INPUT VALUE RATHER THAN LINE OF FROGRAM 
REQD TYPE IS NUMERIC 
LINPUT CINPUT LINE) RATHER THAN STRAIGHT INFUT 
LENGTH OF DESTINATION WHEN STRING TYPE 
—> NEXT BYTE IN TEMPLATE 
LAST RANDOM # BEFORE SCALING 
LS 2 BYTES OF 3-BYTE FRAME COLINTER 
MS BYTE OF 3-BYTE FRAME COUNTER 
7> 1ST USER DEFINED GRAPHIC. 
COORDINATES OF LAST PLOT ETC.8 
(COORDS+1) = Y-COORD. 
COLUMN NO. OF PRINTER POSN 
LS BYTE OF ADDRESS OF NEXT CHAR FOR PRINTER 
COORDS IN LOWER HALF OF END OF KEYBOARD INPUT BUFFER 


(COORDS) = X-COORD. » 


<> SCREEN CHAR UNDER PRINT CURSOR 


LIKE DF_CC FOR LOWER HALF 
SCREEN POSN (COL & LINE) OF NEXT CHAR TO BE OUTPUT 
LIKE S_POSN FOR LOWER HALF 
(SCROLL COUNT) DECREMENTED FOR EACH SCROLL 
CURRENT PERMANENT PRINTING ATTRIBUTES 
LS BIT_OF FOREGROUND COLOUR 
CINK) 


LS BIT OF BACKGROUND COLOUR 
(PAPER) 


-FLASH 
CURRENT PERMANENT PRINTING ATTRIBUTES MASK: 
O FOR NEW. 1 FOR OLD 
CURRENT. TEMP. PRINTING ATTRIBUTES. (BITS AS ATTR_P) 
CURRENT TEMPORARY PRINTING ATTRIBUTES MASK 
ADDITIONAL FLAGS FOR PRINTING: TEMPORARY FLAGS IN 
EVEN BITS: PERMANENT FLAGS IN ODD BITS 
NEW CHARS XOR“D INTO OLD RATHER THAN BEING LOADED 
NEW CHARS INVERTED 
FOREGROUND := COMPLEMENT OF BACKGROUND 


BACKGROUND != COMPLEMENT OF FOREGROUND 
BOTTOM OF CALCULATOR MEMORY (6 NUMBERS) 
—> USER’S NMI SERVICE ROUTINE 
LAST ADDRESS OF BASIC SYSTEM AREA 
-> LAST BYTE OF PHYSICAL RAN 
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ERR.LNI 
ERR_Cr 
ERR_S: 
ERR_T8s 
SYSCON! 


MAX.BANKs EQU SYSCON*2 
CURCBNi EQU MAX_BANK+1 


EQu 


seseese ADDITIONAL 
EQU P_RANT+¢2 
EQU ERRULN+¢2 
EQU ERR.C+2 


ERR_S+1 


EQu ERR.T+1 


‘POINTER TO ON ERROR LINE NUMBER FOR A GO-TO. 
tSTORE LINE NUMBER IN WHICH ERROR OCCURRED | 
SSTORES STATEMENT NUMBER IN WHICH ERROR OCCURRED 
tSTORE FOR “ERROR TYPE’ AFTER A “ON ERR’ 

SYSTEM CONFIGURATION TABLE. 

(LARGEST BANK NUMBER ASSIGNED 

tBANK NUMBER OF THE CURRENT CHANNEL 


MSTBOT! EQU CURCBN+1 ‘ADDRESS OF LOCATION ABOVE MACHINE STACK 
VIDMOD: EGU MSTBOT+2 
' $ NOTE: UNUSED BYTE AFTER VIDMOD 
$. : 
ARSBUF! EQU VIDMOD+2 = sPOINTER TO AROS BUFFER. 
ARSFLG: EQU ARSBUF+2  1tAROS FLAG - BIT 7 SET INDICATES AROS PRESENT. 
‘BIT 4 SET INDICATES NXTLIN POINTING TO AROS. 
‘BIT 3 SET INDICATES DATADD POINTING TO AROS. 
‘THESE BITS BECOME IMPORTANT FOR THE INSERT ROUTINE 
s(POINTERS POINTING TO AROS SHOULD. NOT BE UPDATED 
tFOR AN INSERTION INTO RAM). 
ADATLN: EQU ARSFLG+1 SPOINTER TO THE START OF THE CURRENT DATA LINE 
$ (AROS ONLY) 
DTLNUN: EQU ADATLN*2 $tLENGTH OF THE CURRENT DATA LINE (AROS ONLY). 
STRMNM: EQU DTLNLN+2 sCURRENT STREAM NUMBER, USED FOR BUS EXPANSION 
_.$ UNIT DEVICES. 
MSTACK: EQU 6200H  sLOCATION ABOVE MACHINE STACK 
DRIVES: EQu 6840H  «ISTART OF “DRIVES” AREA 
BANK_ENABLE EQu 6499H 
CALL..BANK Equ 65DOH 
MOVE_S2Z EQU DRIVES~6000H 
DEST7. EQu OFFFFH-MOVE_SZ+1 
FIX EQu DEST7-6000H 
CALL_VBANK EQu CALL_BANK+F 1X 
GOTO_BANK EQuU 6572H sADDRESS OF "GO TO BANK" BANK. SWITCHING 
$ AWARD. 
XFER_BYTES EQu 6722H  sINDIRECT DATA TRANSFER BETWEEN BANKS. 
GOTO_EXT QU 6815H. FOR INITIALIZATION CODE_IN HOME BANK 
+ EXTENTION. : 
SLVM Equ O1ABH ‘ADDRESS OF TAPE ROUTINES FOR SAVE. LOAD 
$. VERIFY AND MERGE COMMANDS. . 
BLDSCT Eau O9F4H  sADDRESS OF INITIALIZATION ROUTINE TO 
$ BUILD THE SYSTEM CONFIGURATION TABLE. 
_ RESSCI EQU OC4CH  sADORESS OF RESET ROUTINE. TO. ADD DEVICES. 
PASSING EQu OFO9H  4ADDRESS OF ROUTINE TO PUSH PARAMETERS TO 
4) THE BEU ROUTINES ONTO THE MACHINE STACK. 
seen 
3 OTHER EQUATES 
sRESTARTS 
ERROR: EQU 6 
WRCHt EQU 16 
IGN_SPt EQU 24 
NXT_IS# EQU 32 
CALCTR: EQU 40 
COPYUP: EQU 48 
NOSIZE EQU 5 $ # OF BYTES IN A FLOATING POINT NUMBER 
DIGIT EQU “0” ’ DIGIT+N IS CODE FOR DIGIT N | 
LETTER EQU 0 $ LETTER+’ALPHA’ IS CODE FOR LETTER ALPHA 
DEBDEL: EQU 5 3 NO. CONSECUTIVE TIMES KB SWITCH FOUND OPEN BEFORE 
; KEY RECKONED RELEASED. 
SCONTROL CHARACTERS (APPEARING ON STREAM) 
COM_cC: EQU 6 + PRINT COMMA 
EDT_cC: EQU 7 + EDIT 
BS_CC! EQU 8 $ BACKSPACE (CURSOR LEFT) 
CRT_CC! EQU 9 $ CURSOR RIGHT 
Cp.ccs EQU OAH $ CURSOR DOWN 
CU_CC: EQU OBH + CURSOR UP 
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RUB_CCr 


AT_CC! 
TAB.CC! 


STY_KC: 
FSH_KC? 
LOL_KC: 
HIL_KC: 
NLV_LKCs 
INV_KC8 
CSUL_KCr 
TM_KCr 

GRM_KCr 
FG_KC: 

BG_KC: 


SPACE! 
QUOTE 
DOLLAR 
COLON: 
CCMMA 
KET 


ERROR: 
WRCHt 
IGN_SP?t 
NXT_IS# 
CALCTR: 
COPYUP : 


NOSIZE 
DIGIT 
LETTER 
DEBDEL: 


COM_CC: 
EDT_CC: 
BS_CC: 
CRT_CCr 
CD_CCs 
Cu,cc: 
RUB_CC: 
CR.CC? 
NLs 
SLUG: 
FORECC: 


AT_CCs 
TAB..CC! 


STY_KCt 
FSHKCr 


LOL_KC: . 


HIL_KC: 
NLV_KCs 
INV_KC! 


§ 
$ 
‘ 
§ 
‘ 
’ 


s CONTROL 


Se 


sRESTARTS 


$ 
$ 
0 ’ 
' 
$ 


RUBOUT 
CARRIAGE RETURN (NEWLINE) 


PRECEDES 5 BYTES OF SLUG 

FOREGROUND 

THE CONTROL CHARS FOR FORE, BACK, FLASH, BIIGHT, 
INVERT & OVER ARE CONSECUTIVE IN THAT ORDER. 

PRINT AT 

PRINT TAB 


CHARACTERS (RECEIVED FROM KEYBOARD) 


STEADY 

FLASH 

LOW. IGHT 
HIGHLIGHT 

NORMAL VIDEO 
INVERSE VIDEO 
CAPS SHIFT LOCK TOGGLE 
TOKEN MODE 
GRAPHICS MODE 
FOREGROUND BLACK 
BACKGROUND BLACK 


STRING QUOTE 
DOLLAR SIGN 


# OF BYTES IN A FLOATING POINT NUMBER 

DIGIT+N IS CODE FOR DIGIT N 

LETTER+“ALPHA’ IS CODE FOR LETTER ALPHA 

NO. CONSECUTIVE TIMES KB SWITCH FOUND OPEN BEFORE 
KEY RECKONED RELEASED. 


sCONTROL CHARACTERS (APPEARING CIN STREAM) 


6 
7 
8 
9 
OAH 
OBH 
OCH 
ODH 
CR_CC 
OEH 
10H 
16H 


a a a | 


17H 


’ CONTROL 


ArWn-o 
oe ee 0 en we 


PRINT COMMA 

EDIT 

BACKSPACE (CURSOR LEFT) 
CURSOR RIGHT 

CURSOR DOWN 

CURSOR UP 

RUBOUT 

CARRIAGE RETURN (NEWLINE) 


PRECEDES 5 BYTES OF SLUG 

FOREGROUND 

THE CONTROL CHARS FOR FORE. BACK, FLASH, BRIGHT, 
INVERT & OVER ARE CONSECUTIVE IN THAT ORDER. 

PRINT AT 

PRINT TAB 


CHARACTERS (RECEIVED FROM KEYBOARD) 


STEADY 

FLASH 
LOWLIGHT 
HIGHLIGHT 
NORMAL VIDEO 
INVERSE VIDEO 
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ATTRTK: 
ATs 
TOK_FN®: 
TABr 
VALSTK: 
LO_MON®: 
BIN_TK? 
OR_TK!1 


LINETKs 
THEN: 
To: 
STEP: 
DEF_TKs 
MIN_KWS. 
CAT.TKs 
FORMTKs 
MOVETK:s 
DEL..TKs 
OPN_TK: 


EQU 
EQu 


OCBH 
OCCH 
OCDH 
OCEH 
DEF _TK 
OCFH 
ODOH 
OD1iH 
OD2H 
OD3H 


L1LO_TKs EQU_OD4H 


MGE.TKs EQU 
VFY_TKs EQU 
-_BEEPTK: .EQU. 
ARC_TK: EQU 
FGTOK: EQU 


INVTOK: .EQU 
OUT_TK1. .EQuU 
LPRTK: EQU 
LL_TK: EQU 
STOPTK: EQU 
READTK: EQU 
DATATK: EQU 
RESTTK: EQU 
NEXTOK EQU 
DUMPTK: EQU 


BORDPTs EQU 


ODSH 
OD6H 
OD7H . 
OD8H 
ODSH 


FOTOK+S 
ODFH 
OEOH 
OE1H 
OE2H 
OESH 
OE 4H 
OESH 
OF 3H 
OFFH 


OFEH 


A SE ee we OO we we os Ot WE a we we we ae oe on bn we we ot wt of wt ob ue on os wt 5 20 68 we oe cf ws we ot cf cf ws ae wt we oF 


CAPS SHIFT LOCK TOGGLE 
TOKEN MODE 

GRAPHICS MODE 
FOREGROUND BLACK 
BACKGROUND BLACK 


STRING QUOTE 
DOLLAR SIGN 


PRESTEL CODE .FOR /€@- 
iST STANDARD GRAPHIC 
1ST USER-DEFINED GRAPHIC 


1ST TOKEN 


“AT? 

1ST TOKEN TO REQUIRE A SPACE AFTER 

“TAB’ 

“VALS- 

TOKEN FOR 1ST MONADIC OPTR AFTER VAL$ (CODE) 

“BIN’ 

“OR’ NB THE TOKENS FOR OR. AND. <=, >=, 
CONSECUTIVE IN THAT ORDER. 

“LINE? 

“THEN? 

“TO’ 

“STEP’ 

“DEF- 

1ST.TOKEN THAT IS A KEYWORD RATHER THAN OPERATOR 


<> ARE 


“DELETE” 

‘OPEN’ 

“CLOSE? 

“MERGE- 

“VERIFY’ 

“BEEP? 

“ARC- 

“FOREGROUND’ NB THE TOKENS FOR FORE, BACK, FLASH, 
-BRIGHT, INVERT & OVER ARE CONSECUTIVE IN THAT 
ORDER. 

“ INVERT’ 

"“QUT’ 

“LPRINT’ 

“LLIST’ 

“STOP? 

“READ’ 

“DATA? 

“RESTORE” 


OUTPUT PORT FOR SETTING BORDER COLOUR 
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PRLIN® EQU 
PROUT: EQU 
KB_PT: EQU 
OWPORT! EQU 
T_PORT: EQu 
TAPE_I:EQU 
DKHSPT: EQU 
BDATPT: EQU 
BCMDPT: EQU 
HREXPT: EQU 
CHAN_K: EQU 
CHAN_S: EQU 
CHAN_R: EQU 
CHAN_P: E&QU 
CHLSET: EQU 
#EJECT 

IFJUMPs EQU. 
ExcH: EoQu 
LOSE: EQu 
SUB: Eau 
TIMES: EQU 
DIv: Eau 
POWER: EQU 
ORs EQu 
AND: EQu 
OTs EQu 
ADD: EQu 
STGAND: EQU 
CONCATs EQU 
VALS: EQu 
USRS: EQu 
INKEY: EQU 
NEGATE: £QU 
CODE: EQu 
LO_MON: EQU 
VAL: EQU 
LEN: EQU 
SINt Eau 
cos: Eaqu 
TAN: EQu 
ASNI EQu 
ACS: EQu 
ATNE EQu 
LNe EQu 
EXP: EqQu 
INTs EQu 
ROOT: Eou 
SON: EQu 


OF BH § FOR INPUT FROM PRINTER 
OF BH § FOR OUTPUT TO PRINTER. : 
OFEH 8 INPUT PORT FOR READING KEYBOARD 
OFEH t OUTPUT PORT FOR TAPE 
OFEH t INPUT PORT FOR TAPE 
6 $ TAPE INPUT BIT IN (CI_PORT) 
3 #2+ADDI TIONAL 
OF 4H + DOCK HORIZONTAL SELECT PORT 
OFCH 3 EXPANSION BANK DATA PORT 
OF DH $ EXPANSION BANK COMMAND FORT 
OFFH * HOME ROM EXPANSION BANK PORT 
$ tae 
‘OFFSETS FROM (CHANS) OF PERMANENT CHANNELS 
fe] ’ KEYBOARD 
Ss ’ TV SCREEN (UPPER HALF) 
10 $ RAM INSERTION 
1S 3 ZX PRINTER 


4000H-94#8 + ADDRESS OF CHARACTER SET (STARTING WITH SPACE) 


SCALCULATOR COMMANDS. IN THE DESCRIPTIONS. T & S STAND FOR 
3 THE TOP & SECOND FROM TOP ON THE CALCULATOR STACK. 

$ WHERE NECESSARY. FULLER DESCRIPTIONS CAN BE FOUND AT THE 
s CODE FOR THE RELEVANT ROUTINES. 


STHE FOLLOWING COMMANDS HAVE THE STACK POINTERS HL & DE (BUT 
8 NOT (STKNXT)) DECREMENTED FOR THEM BY CALCTR BEFORE THEY 
t ARE CALLED (STKDWN). 


(?) tS.T -> St RELATIVE JUMP CONDITIONAL ON VALUE OF T. 

TF JUMNP+1 8 (EXCHANGE) S.T -> T-S 

EXCH+1 ‘ST Ss 

LOSE+1 8s (SUBTRACT) S.T -> S-T 

SUB+1 $S.T -> SeT 

TIMES+1 I(DIVIDE) S.T -> S/T 

DIV+1 $S,T ~> SeeT 

POWER+1 3S-T -> S OR T (SEE OR). 

OR+1 $S.7 -> NUMERICAL S AND T (SEE NOAND). 

AND+4 $S»T -> NUMERICAL SOT 
tS NUMERIC COMPARISON OPERATIONS HAVE NOT BEEN GIVEN 
3 MNEMONICS. S.T -> S“T WHERE ~ IS <=,5=,<>.>,¢ OR = 
* SEE CMPRSN. 

AND+7 $S.T -—> S+T 

ADD+1 1S6.T -> S& ANDS T (SEE STGAND). 
36 STRING COMPARISON OPERATIONS WITHOUT MNEMONICS. 

STGAND+7 $S8.T$ -> S& +6 TS 


SORDINARY OPERATIONS WITHOUT STKDWN. 


CONCAT+1 ‘TS -—> VALS TS 

VALS+1 sT$% -> ADDRESS OF BIT PATTERN FOR CORRESPONDING 
t USER-DEFINED GRAPHIC 

USRS+1 tT -—> INKEYS #T 

. INKEY+1 - -§T >-T 

NEGATE+1 $T$ -> CODE TS 

CODE SOPERATION CODE FOR LO_MON 

CODE+1 tTs -> VAL Ts 

VAL+1 TS -—> LEN TS 

LEN+1 tT -> SIN T 

. SINL $T. => COS.T 

Cos+1 tT -> TAN T 

TAN+1 8T -—> ARCSIN T 

ASN+1 tT -—> ARCCOS T 

ACS+1 $T -> ARCTAN T 

ATN+1 ‘T -> LNT 

LN+1 $T. -> EXP. T 

EXP+i tCINTEGER PART) T -> INT T 

INT+1 $T -> SQUARE ROOT OF T 

ROOT+1 tT -> SON T 


156 


ABS: EQU 
PEEK3 EQuU 
INS EQu 
USR: EQu 
STR: EQu 
CHR: EQu 
NOT: EQU 
ZERO?: EQU 
DUP: EQu 
INTDIV: EQuU 
JUMP s EQu 
LITERAL EQU 
LOOP: EQu 
MINUS? EQU 
PLUS?: EQU 
QUIT: EQu 
ANGLEr EQU 
TRUNG: EGU 
XEQTB: EQU 
XEYs EQu 
FLOAT: EQU 
CBSvr- = EQU 
CONST: EQU 
MINUS1:EQU 
Copy: EQu 
MEMORY: EQU 
OP_TK: EQU 
HI_MON: EQU 
MONOP: EQU 
LONOMO: EQU 
HINOMO: EQu 
*LIST ON 


SGN+1 8’ (ABSOLUTE) T -> \T\ 
ABS+1 3T -> PEEK T 
PEEK+1 *T -> INT 
IN+1 $1T -> USR T 
USR+1 tT -> STRS T 
STR+1 *T -> CHRS T 
CHR+1 *T +> BOOLEAN (T = 0) 
NOT 
NOT+1 §(DUPLICATE) T -> T.T 
DUP +1 SCINTEGER DIVISION) S.T -> S MOD T. INT(S/T) 
INTDIV+1 SPROGRAMME CONTROL - RELATIVE JUMP BY FOLLOWING BYTE 
JUMP + 1 SSTACKS. FOLLOWING NUMBER. 
LITERAL +1 SLIKE ZILOG DUNZ 
LOOP+1 $T -> BOOLEAN (T < 0) 
MINUS7+1 tT -> BOOLEAN (T > ©) 
PLUS?+1 SRETURNS CONTROL. TO z80 
QUIT+1 tT -> Y WHERE -1 <= Y <= +1 & SIN T = SIN (PI/2#Y) 
+ MEMORY O t= TRUE IF T IN 2ND OR 3RD QUADRANT 

ANGLE +1 * (TRUNCATE) T <-> INTEGER TRUNCATION OF T TOWARDS oO. 
TRUNC+1 SEXECUTES (BREG) AS A CALCULATOR INSTRUCTION 
XEQTB+1 8ST -> S # 10e8T 
XEY+1 *T FORCED INTO FLOATING POINT FORM 

' THE FOLLOWING COMMANDS HAVE ADDED TO THEM AN GPERAND, N. 
80H sSUMS N TERMS OF CHEBYSHEV SERIES (SEE CBSV). 
CBSV+20H (CONSTANT) T -> Ts NTH CALCULATOR CONSTANT 
CONST+6 SCALCTR CONSTANT EQUAL TO -1 
CONST+20H *T -> Ts T COPIED TO NTH CALCULATOR MEMORY 
COPY+20H $T -> T. CONTENTS OF NTH CALCULATOR MEMORY 
LO_MON-LO_MON $ TOKEN FOR MONADIC OPTR C IS OP_TK+C 
OP_TK+CHR + TOKEN FOR LAST MONADIC OPTR EXCEPTING NOT 
LO_MON. OR. OCOH SOPERATION CODE FOR LO_MON. TOP 2 BITS SET. 
OP_TK+SIN % TOKEN FOR 1ST (NUMBER) NUMBER OPTR AFTER - 
OP_TK+USR $ TOKEN FOR LAST (NUMBER) NUMBER OPTR 


157 


APPENDIX C-l 


64 COLUMN MODE 


TIMEX COMPUTER CORPSRATION 


BESLICAITIOb DEXELGOSENT LICRASY 


daclicasian Sofssace Camecoeos 093 


66-COLUMNM MODE 


Sate: 12715783 
aSC Number: 001 
Versien: 062 


Author: Carel Cerceran 


Maee: 66 Coluen Mode Suppert 
Descristien: 


This component provides support te the epplication pregreemer for 
using the 64-colusn mode feature of the TS 2068. The services 
include epening/clesing the secend display tile (seving the 
machine etacks OS RAM reutines and BASIC structures), PRINT 
Desitien control, attribute contrel, clear screen and screil 
Screen services ané display of charscters. Fer ease of use fres 
BASIC, statue is returned in the OC register peirs usually 
tor successful completien and 
ether cenditiens. The interface 
POKE°ing the input perasmeters to designated Rin 
to invoking the service via the US® function. See page 4 ef the 
code listing fer the wemory addresses to be used from BASIC sith 
the suspert code loadee starting at Chunk F €£000n7573464). 


Yecsiao Cootcel 


Version Cescristion Cate 
01 Original : 11720703 
002 ado: 12728783 


1) Stde. and User- 
Cefined Graphics 
te WRCHAR and 
GrCcwar. 


2) WRSTRG Curate String? 
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Acclisation Secxices 


Memes SETMGDE (CSETMDB free BASIC - pereneter te VINSDE) 


Input: MODE COsnermald » 6964 column pede> 


Peep machine code: Register A 
Pros BASIC: In VIMOOE 


Description: 


Sets specified video mede,y opening of clesing the second display 
file where neede This invelves determining if there is enough 
free RAR to epen the second @isplay file and if se, seving the 
BASIC structures and machine language variables area up-and the 
UDG sree doen te make space fer the eechine stack and OS Aan 
Peutines at the ten eof seaory. Tne secend disclay file is 
Cheared te zerees. The affected system and internel variables 
are updated or initialized (see Usage Section). when returning 
to Mode 0 frem 64 Coluan mode, the structures are returned te 
thoar normal lecations. 


Dutpuer BC = 0 Succesatul 
OC #1 Inveli¢c peremeters (not equal te 6 er 6) 
eC = 2 Net enough nesery 


Momet CLRSCH CCLASCS from BASIC - parameters te CLSCTL) 


Inmeuts Line Count (1-24) 
Starting Line Number (0-23) 


Frem Machine Codes Line Count In Register 8 
Starting Line In Register C 


Frew BASICS Starting Line Mueber in CLSCTL 
Line Count in CLSCTL © 3 


Descrigtion? 


Clesers to background celer CPAPER) the designated nuaber ef 
lines, veginninge with the Starting Line Number, Line 0 with a 
count of 24 clears the entire screen. Upen returns, the curser 
pesitien is at the beginning of the first Line clesred. 


Output: 8C © 0 for successful completion 
OC © 1 invalid pareneters 
CLine Number © Line Count C1 er 524) 


see eee erercnnzmeeezreneerenr eee ezreeenewneenexe ewe 


Name: SETCUG CSETCUS from BASIC - parameters te LINCOL) 


Input! Line Number (0-23) 
Column Number (0-63) 


Free Machine Codeit Line Nusber In Register 6 
Celvan Nuaber In Register C 


from SASIC: Celuan Number In LINCCL 
Line Nuveper In LINCGL ¢ 1 


Descristiont 


Converts the requested pesition te internal formats deteraines 
Ciseley file addreasse and ateres the values fer use by the next 
disclay character operation. Nete thet ence established, 
position is vedated eutometically sehen #8 character is ¢ 
se that 1¢ £8 ently necessery te set the position when sequential 
siscley is net desired. 


Outaue: OC = 06 fer succeseful completion 
BC © 1 for invalid parametera Cline Number > 23 5 
Celvan Nusber > Line Length-1) 


sees eceecrenereeneneeneeweeneneseecern eee eoe eee ee = 
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Nawet SETATT CSETATS trem BASIC - paremeter te ATTCTL? 


Tneut: Attribute Byte = bit ? = FLASH 
bit 6 = BRIGHT 
bit S =P 
bit @- A 
bit ye PER 
bat 2-1 
bit rte 
bit O- « 


Feom Machine Codet Necister & 
From BASIC: In AYTCTL 


Descristien: 

The soecitiod INK ceoler CO-7T) 19 vse te set the vides sede 
hardesce and te updete VIONOO. The complesentary PAPER cooler is 
fixed by the INK selection. FLASH and BRIGHT are fixed st rere 
Sy the herdware. Nete thet in 64 celuen nede the entire sereen 
hes the sane attributes. 


Cuteut: 8C 2 0 Successful 


Wewed SETMSK CSETMSE from BASIC = pareeters to MASKCTL) 
Tnput: Mask Byte = bit © - OVER 
bit 2 = INVERSE 


Fror Machine Code: Register & 


From BASICS MSKCTL 


Description: 


The specified mask is stered for applacetieon te all subsequent 
display character operations. COVER «© 1 imelies new cheracter 
combined with old using an KOR eperataen? INVERSE © 3 ieplies 
character is inverted). 


Dutewt: BC = 0 for successful coagcletion 


weer eeeeawnereennr eee sceeaereenene2xncneweeneneve 


Mamet WRCMR CURCHS free BASIC - paraeeter to DATAB> 


Input: Character code fer character to be displayed 


20m TO Tem = Std. T52068 Crharecter Set 
GOm TO GFH = Std. Graphics Set 
90m TO AGW = User-Defined Graphics Set 


Pree Meochine Ceees Register A 


Prem BASIC: in DATAR 


Oescriation? 


Orsclays character at current curser pesition, epplying current 
@esk. Mev curser position en te nent sequential pesitien. If 
character weuld start 8 nee line efter BOTLN Caee Usage sectien) 
and the serell count (variable SCRLCT) decrements te sere, the 
cherecter will net be displayed and return vill be mage with OC 8 
3 Cacreenr full). If the Fell count dees net decrement te eres 
the sereen ail] be scrolled up ene line using the infereatien in 
SCRCTL ane the new Line started st the vacated line. 


Ovteut: 8C © 6 for successful coarletion 
ec 1 invalid character cede 


s 
OC = 3 fer screen full 
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Nawet WRSTRG CuRSTRS frem BASIC - String Identifier in PaRars) 


Imeut? Creracter Cede String 


Prem wachine codet Address of etring in HL 
Count in OC 


Pree BASIC! String Variable Identifier in : 
System Variable PARAMS = 239747 (SCC3M) 


Jescrisatien: 


Cisplays the characters from the string, beginning at the current 
curser lecation and centinuing sequentially until the count 
expires, of “Screen Full’ is detected (nee URCMR geseriptien and 
Usage Section on Automatic Scerelling). Per the Screen Full 
condition, the remaining count is stered in the internal variable 
STRGCYT fer access by the user. 


NOTES Characters sithin the string ehich are eutsice of the 
erted range (32 threugh 164 (20M-46H) > will be 
Eng» BASIC Token cedes and centrel codes 
embedded in an INPUT string will net ve displayed or 
decoded. 


®rom BASICe POKE the cede for the string varioble igentifier into 
PARAMD arier te inveking WASTRBEs 0.9. 


0008S LEV atatqmmmogtringenmoen* 

0016 PCE 23747,CCOE "a* 

Q01S TF USR CWRSTREI<CDE THEN oon-- 
(continue) 


Gutputs 8C 2 0 Successful 
sC = 2 28S$IC + String not found 
6C = 3) Screen Full + Remaining Count in STRECT 
Cheb sCurrent dddress in String) 


Nawe? SCRCLL CSCRLB from BASIC - parameters to SC&CTL) 
Input? Line Ceunt (1-23) 
Starting Line Nueber (1-23) 
From Machine Code: Line Ceunt In B 
Starting Line In C 
Prom BASIC: Starting Line In SCACTL 
Lane Count In SCRCTL © 1 
Deseriction: 
Scrells the designated nuaber ef lines ue 1 position, starting at 
the specified line nveber and inserts @ blank line at the bettos 
ef the scrolled ares. Line sith a count of 23 will serell the 
entire screen up i lines. Unen returns the curser position is at 
the beginning ef the inserted Blank line. 
Nete! See Usage Section on “autematic’ serelling. 
Outeuts 68C s @ Successful 


C «3 Invalid Paraseters 
Cline Number © Line Count < 1 er > 26) 


Wane: GETATT CGETATS free BASIC - paresecters te GETCTL) 
Trout: &s fer GTCHAR 


Deseriptions 

Returns in register C ef the OC register pair the attribute syte 
for the character at the designated screen pesitien. Nete that 
in 64 coluan mode the entire sereen has conasn attributes. The 
value returned aill describe the current selection: 


Outeut: BC 2 2 for invalid parameters 
SC = attribute byte Cas fer SETATT) 
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Nawes STCNHAR COYCHRE free BASIC - parameters te GETCTL) 


Input: Line/sColuan pesition as fer SETCUR 


Frew Machine Code: Line Number in 6 
Celuen Number in ¢ 


From BASIC? Coluan Number in CETCTL 
Line Nueber in GETCTL « 2 


Descraction: 


Returns in register C ef the BC register pair the character code 
for the character at the designated screen pesitien. If ne aatch 
mopinst the ecnaracter set Cincluding the standard = and 
us tined graphica) is feunds sere is returned. (Character 
code or rere also returned in a.) 


Note: Positions ‘printed’ waing the OVER technique will return 
rere if they do not match against eny single character. 


Output: 8C = O fer no find 
BC = 2 invalic paraseters 
BC = character cede (20n-86H) 


Mame: GETCUR CGETCUS free eaSIC) 


Input? None 


Description: 


Returns in the 8C register pair and in the BASIC parameter 
location LINCOL,. the current print position Cuhere the nest 
cnarscter seuld be disslayed). 


Juteut: Bs Line nueber (0-23) 
Cs Colusa number (0-63) 


BASIC: LIMCOL - Coluan nuaber 
LincOu © 1 = Line nuader 


NOTES If the last character eas erinted at Col.63 ef Line 
23 Clast pesitien en the acreends then Col.O/Line 23 
wili be returned. 


i ee ey 


Usasa|s 
Memory Usage: 


This package of machine coce routines includes the following 
anternal variables: 


Naewe Size Gescription 
SCRCTL 2 Scroll Centres 
LS6 = Starting line number 
MS8 © Number of lines to be scrolled 


SOTLN 1 Bottom Line - Line number (0-23) after which 
test for seroll will be made. 


SCRLCT 1 Scroll Count- Nuaber of times ¢ 1 that 
automatic scroll will be done. 
When decremented to rere, data 
will not be displayed and a 
congition cece will be returned 


to user. 
CHTeL 2 Character Table (Base Address-100H) 
GRveL 2 Std.Graphics Character Table (fase-100H) 
LINLEN 1 Line Length = (64 when in 64-Col.Mode) 
CurPos 2 Current Position CiInternal Format) 


LSS = Coluen Position 
mS8 = Line Position 


OFACOR 2 Current Cisplay File Address 


MASKS 1 Mask Byte Cbit 0 = OVER) 
Cbit 2 © INVERSE) 
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arTert i Attribute Syte Cbits 0 - 2 - INK) 
Cbits 3 - S$ = PAPER? 


Coit 6 - BRIGHT CSet to zero 
(bit 7 - FLASH by "ZW in 
€4-col.mode) 
GTINOK 1 Get’ Index - Used by GTCHAR 
STRGCT 2 String Count - Contains remaining dyte count 


when 8C=2 (Screen Full) is 
returnea from the weite String 
service WRSTRG CwRSTRE). 


Inmataal values set via SETMEDE CSETMSE) are as tollows: 


variatle Wame Value 


SCRETL 17?Cis 
@cTin 17” 
SCRUCT dn 
CmTe, 2C00n 
GRISL CInternal to Module) 
LINLEN aGh 
CuePcs 18<1h 
DF AGC 400Chn 
MASKE On 
STTEYT 38 
OTINIX Bon 
STRGCT On 


The follcwang are the variables used for passing parameters in 
@asIc. Tne * insicates tnose initialized by SETMOB: 


Variable Name Size Value 
= COTAB i on 
@ LINCCL 2 On 
& CLARCTL 2 1800 
we ATTCTL 1 36H 
* ASKCTL 1 on 
© GETCTL 2 On 
VIMCOE 1 


In addition, VIOMOD, PARAMS and other system variables must be 
available to tnese routines. At minimum, chunks 0-3 and chunk 7 
must de enadled in the mome Bank. 


Location: 


This package can be incorporated into a machine code prograa 
within tne memory range from chunk & through 7. taking into 
consiceration the remarpaing of certain structures when the second 
disclay file as open. NOTE: Machine code above RAMTOP is not 
moved. 


Tne routine SETMCOE (SETMD3) cannot be executed from a cartridge 
because of the necessity to enable the ROM Extension wnichn 
disables the OCCKR Benk, 


Registers: 


Other than as documented for output values, mo claims are made as 
to oreservation cf any register contents except for the IV 
Register whirt must always contain the value SC2AmM for access to 
the sterdard syste variables. 


Automatic Scrolling: 


As anitialized, test tor scrolling will be made when the print 
position goes to the next line following the bottom line on 
screen CSOTLN23e24th lined. Condition Code 3 (Screen Full) will 
be returned sance SCRLCT wall decrement to zero. If SCRLCT is 
set to some larger value, then the par ters in SCRCTL will be 
usec to automatically scroll the esignated number of lines 
beginning at the specifies line nuabter. As initialized, this 
will scroll the entire screen ube By performing a POKE or 
setting the variadles BOTLN and SCRCTL to tne desired valuese 
automatic scrolling can be «Gone using smaller sections of the 
scraen. when working trom BASIC it is recommenced that BOTLN be 
set to Line 21 (15%) and SCRCTL¢! be set to 21 CiSH) to avoid 
conflict with tne Edit Line which uses the dottom two lines of 
the screen. Note that once SCRLCT expires, it will be set to 1. 
If a aifterent value is desired, it must be reinitialized by the 
user after receiving the “Sereen Full’ condition. 


By setting the SCRCTL variable and invoking the SCROLL (CSCRLBD 
routine any portion of the screen may be scrolled at any tine. 
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NOTES: 


1. All screen cperations dene dy the system ROM CPRINT, LISTs 
Edit line 170, CLS, serollings, etc.) relate enly te the 
main Oisplay File. This means that enly the even celuans 
on the 64-coluan mede screen will be affected. Yeu sill 
want to execute the Clear Screen function in this sodule 
to guarantee that no Gata in the second display file 
interferes sith the use ef a system screen servicer 6.96 
prior to doing o LIST. 


2. The COPY command will print only the even coluans of the 
screen to the 2040 Printer. 


3. During tape operations, the Border will not change while 
in 64-colusn moge since this is fixed by the hardware to 
contora to the pacer color. 


4. Tne SAVE filename SCREENS will save only the main Disslay 
File cata. The second can be saved by s SAVE filename 
CODE 24576, €14¢6. be careful thet you have tne covputer 
in 64-column moce when you load this data or you will 
everwrite the OS RAM routines and “crash” tne systeall 
(The count tor saving the display file is for the dats 
fortion only since the Attribute File area from T800H- 
TAFFM C3CT2Z0<-31487) is not used by the video moge H/u 
in €@-Column mode. 
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OAtves fou 6860n t 
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APPENDIX C-2 


80 COLUMN MODE 


Sate: 12716783 
4SC Nusders 002 
Version: 003 


Author: C. Corcoran/sS. Soyle 


Name: 80 Column Mods Support 
Cescription: 


This component prevides support to the epplication programmer tor 
useing the 80-coluan mode feature of the TS 2068. 80-Colunn node 
is amclementes by using the 64-Coluen Pose feature of the 2068 
end modifying the charecter sidth free 8 te 6 pisels. The 
services include opening/closing the second display file (aeving 
the machine stacks OS RAM routines and BASIC structures), PRINT 
position control, attribute contrel, clear sereen and sereli 
screen services and display ef characters For ease of use fros 
BASIC, status is returned in the BC register parr, usually zero 
for successful completion ane designated nen-zere values tor 
Oiner conditions. The interface from BASIC is by means of 
POKE’ang the input parsmeters to designated MAN locations prior 
tc amveking the service via the USK functien. See page 4 of the 
code listing for the eemory adoresses te be used from BASIC with 
tne support code loaded starting at Chunk 7 CE000N/57344). 


Asalisation Services 


Nemo: SETMOCE CSETMO® from BASIC - parameter te VIMODED 


Input: MODE COenoreal » 8980 coluan mode) 


From aschine code: Register & 
froe BASIC? In vinooe 


Description: 


Sets specified video sede, opening er closing the second display 
file here needed. This involves determining if there is eneugh 
free RAM to open the second display file and if se, seving the 
BASIC structures and sachine language varisbles eres up and the 
UDG sree deen te make space for the machine stack and OS RA" 
Poutines at tre top ef sesory. The second disslay file is 
cleared to rerees. The affected systea and internel veriedles 
are updated or initiplized (see Usage Section). When returning 
te Fede 0 free 00 Coluan mode, the structures are returned te 
their noraal locations. 


Outeut: ac 2 0 Successful 
eC = 1 Invalid parasetare (net equal to 0 er 6) 
oC = 2 Not eneugh senery 


ed 


Mamet CLASCH’ CCLASCR from BASIC = parameters te CLSCTL? 
Trout? Line Count (1-24) 
Starting Line Nusver (0-239 


Peoe Machine Coder Line Count In Register 8 
; Starting Line In Regieter C 


Prom BASIC? Starting Line Nusber in CLSCTL 
. Line Count in CLSCTL © 1 

Descriptions 
Clears to background cooler (PAPER) the designated number of 
lines beginning eith the Starting Line Number. Line 0 sith os 
count of 24 cleare the entire screen. Unen returns the curser 
sosition is at the beginning ef the first line clesred. 
Outeut? BC 2 0 fer succeseful completien 


$C = 1 Lnavalié parameters 
(Line Nuaber © Line Count <1 er >24) 
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eee eee ewnnee eee ewnewne ee eee en srw wnewe 


Wamet SETCUR CSETCUB froe BASIC = parameters to LINCEL) 


Tnput? Line Number (0-23) 
Celuan Musber CO-79) er (0-04) 


From Machine Code! Line Number Im Register B 
Ceoluan Nuaber In Register C 


Prose B8aS1C2 Celuan Number In LINCOL 
Line Number In LINCOL © 3 


Description: 


Converts the requested position te internal format, determines 
Giselay file adder and steres the values fer use by the next 
Gisclay character ration. Note that once established, the 
Desition is updated sutosstically shen 8 character is diselsyed 
pe that it is only necessary te set the sositien shen sequentio) 
diselay is net desired. 


Output: 8C = O for successful completion 
eC © 1 fer inveli¢ perseeters (Line Number > 23 , 
Celuan Number > Line Length-1) 


Wawes SETATT CSETATS from BASIC peremeter te ATTCTL> 


Input? Attribute Byte = dit 7 ~ FLASH 
bit 6 - BRIGHT 
bit S-P 
ete ee A 
eit 3 - PER 
bit z2-12 
bitte 
bit 0 = ® 


Prose Machine Cede: Register A 
Prom BASIC: In ATTCTs 


Deserietion: 


The specified INK color CO-7) is used te set the vides sode 
horewere ond te update VIDHOD. The coaplementary PAPER coler is 
dined by the INK selection. FLASH one BRIGHT are fixed st rere 
wy the hardesre. Note that in 80 celuen mode the entire screen 
hes the seve ettributes. 


Duteut: 8C © 0 Successful 


Nemet waChHR (WRONG from BASIC ~ weraseter te OATAS) 


Inout: Character cede fer character te be displayed 


20m TO TEM = Std. TS2068 Character Set 
a0m TS OFM = Std. Graahics Set 
90n TO AGM ~ User-Defined Graphics Set 


Prem Machine Codet Register A 


Pree Basic: in DaTas 


Oescrintion: 


Displays character at current curser pesitien, spelying current 
ee Moves cursor positien on te next sequential pesitien. If 
enaracter sould start a new line after GOTLM Csee Usage section) 
and the serell count Cveriable SCRLCT) decree @ teres the 
character sill not be disgisnyed and return eill be @ #ith 8c © 
3 (screen full). [If the serell count does net decresent te rere, 
the screen aill be scrolled up ene line using the infersation in 
SCRCTL and the now line started at the vacated line. 


Nete that only the first 6 bits of each byte in the User Oefined 
Graphics aree will be transferred te the diselay file. 


Ovtput: 6C = 6 fer successful coapletion 
OC o 1 invalid cherecter cade 
BC = 3 fer screen full 


178 


Ce 


Mawes SETMSK CSETMSS from BASIC - caraeters to 4MSECTLD 


Incut: Mask Byte <- bit G = CVER 
bit 2 = INVERSE 


Srae “Yachine Coge: Register & 


Feom BASICS MSKCTL 


Sescriction: 


The specified sask is stored for apglication to all subsequent 
display cherscter ocerations. COVER © 1 implies nese character 
combined with o1d using an X08 operstions INVERSE © 1 iaclies 
character is inverted). 


Gutput: 8C = C for successful coapletion 


ee 


Wares WRSTRG CWRSTRE from BASIC = String Identifier to PaARAns) 


Input: Crarecter Code String 


From machine code: Address of string in HL 
Count in BC 


From BASIC: String Varistle Identifaer in 
Syatee Variable PARAMS = 23747 CS5CC3N) 


Cescription: 


Clacleys the characters froe the string, deginning et the currant 
cursor lecation and continuing seauventially. until the count 
expires, or “Screen Full’ is cetected Ceee WRCOHR description and 
Usege Section on Automstic Serollang). For the Sereen Full 
condition the remaining count is steered in the internal verisbdle 
STRGCT for secess by the veer. 


NOTE: Characters within the string which ere outside of the 
supported range €32 threvgh 166 C20N-A4H) ) aill be 
ignored. Eapes BASIC Token codes and contrel codes 
esbeddec in sn INPUT string #111 not be displayed or 
decoded. 


From BASIC, POKE the code for the string variable identifier into 
PARAMS prior to invoking WRSTRB, @eg- 


O00S LET ateBucmn-stringommeon® 

0010 PORE 23747,CODE “a” 

D015 IF USR CWRSTRBEDC>O THEN ~none 
(continue) 


Output: 8C #© O Successful 
#c = 2 BASIC = Steing not found 
8C #@ 3) Screen Full - Remaining Count in STRGCT 
CML sCurrent Address in String) 


Name: SCRELL CSCRLB frem BASIC - parameters to SCRCTL? 


Input: Line Count (1-23) 
Starting Line Number (1-23) 


From Machine Codes Line Count In B 
Starting Line In C 
From BASIC! Starting Line In SCARCTL 
Line Count In SCRCTL © 2 


Description: 


Serells the designated number ef lines up 1 position, starting at 
the specified line nurber and inserts & blank line at the botton 
of the scrolled area. Line 1 with a count eof 23 will serell thre 
entire screen up 1 line. Upon returns the curser pesition is at 
the becinning of the inserted blank line. 


Note? See Usage Section on ‘automatic’ scrolling. 
Outeut: OC = 0 Successful 


8C = 3 Invalid Paraseters 
Cline Number © Line Count < 1 er > 26) 
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Mamet GYCHAR CETCHRE free BASIC = parameters te GETCTL) 


Tnput? Line/Colvan position es fer SETCUR 


Prem Machine Cedet Line Nuaber in 8 
Colven Number an C 


Pree BASIC? Coluan Nuebder in CRICTL 
Line Nueber in GETCTL « 1 


Deseriotion: 


Returns in register C of the BC regis gate the character code 
fer the character at the @ enated screen pesition. If no motch 
egsinet the character set Cineluding the standard ane 
user-eefined grephics) is feunds rere ie returned. (Character 
code or sere slee returned in &.) 


Netet Pesitions “srinted’ using the OVER technieue #41] return 
sere if they de net match sgainst any single character. 


Juteut: OC 2 0 fer ne tine 


BC © 1 invalid parameters 
OC = charactor code (20n-a4n) 


Mamet GETATY (GETATE frem BASIC - parameters te GETCTL) 


Input: As fee GTCHAR 


Oeseristieont 

Returns in register C ef the BC register pair the ettripute byte 
fer the character at the designated screen pesition. Nete that 
in 00 column mode the entire screen has commen attributes. The 
value returned will describe the current selection! 


duteut: 8C = 1 fer invalid parameters 
OC © attribute Byte (Cae fer SETATT) 


ee ese weereeeneceeeceeeneneneneeneeawe nena wo « 


Wawe: GETCUR CGETCUBR free BASIC) 


Inputt ene 


Descriction: 


Returns in the 8C register pair and in the BASIC paremeter 
lecation LINCOL,. the current print pesition Cwhere the next 
cherecter would be eisplayed). 


Juteut: 8 © Line avaper (6-23) 
C @ Celuan nueber €0-79) er (0-86) 


Basics LINCOL = Column nuader 
LInCOL ¢ 1 = Line avaber 


WOTES If the last character sas printed at Col.?9 (86) of Line 
23 Clast position on the screen), then Col.O/Line 23 
#111] be returned. 


Ceo O88 we wee eo Bee eee eee ween sees ene se ewee ene seceaneweoones 


Usases 


Memory Usage: 


Talis package ef machine cede routines includes the felloaing 
internal variables: 


Nase Saze Descristieon 
scacta 2 Serell Contre) 
LSO = Starting line nuaber 
“$8 © Number ef lines te be scrolled 


SOTLN i Bottom Line + Line number (0-23) after which 
test fer screl) will be aade. 
scaucr i Serell Ceount- Nuaber ef tines « 2 that 


autesstac screll will Be cena. 
Wren decremented to zere, data 
will net pe diselayed and s 
condition code will be returned 
te user. 
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Cures 2 Cnerecter Table (Sese Address-100N) 


GRTBL 2 Sta.Graphics Character Table (Base-1690H) 
LINLEN a Line Length - (80 er 85 when in 80-Col.mede) 
cugpos 2 Current Position CInternal Fersat) 


LS$8 © Coluan Position 
PSB © Lane Position 


DF ADOR é Current Display File Address 
maSKe 1 Mask Byte (eit 0 © CVER) 
Cbit 2 = INVERSE) 
arrery i Attripute Byte Cefes O = 2 = Ima) 
Cdbits 3 - 5 = PAPER) 
Cbit 6 = ERIGMT CSet to zero 
cbit 7 - FLASH by We in 
80-cel.acce) 
GTINOS i "Set? Inden = Used by GTCHAR 
sS7eccrT 2 Strang Count - Contains remaining byte count 


wner &Ce? (Screen Full) is 
returned from the write String 
service WRSTRG CWRSTRE). 


MARGIN 1 Margin - Margin Adjust (0-2) 
DFBIT 1 Display File Bit - Current Bit PosItion 


Initial values set via SETMCOE CSETHOS) are as follows: 


Variable Name Value 


SCRCETL 17014 
aCTLN 17 
SCRLCT 14 
CmTee CInternal to Module) 
GRTEL CInternal to Module) 
LINLEN SOn 
curecs 18518 
OF ADOR 4000 
MASKS On 
ATTOYT 384 
GTINCX 80H 
STRGCcT On 
MARGIN in 
OFSIT 7a 


The following are the variables used for passing parameters in 
BASIC. The « indicates those initialized by SETMOB: 


Variable Name Size Value 
= OATAB 1 On 
® LINCGL 2 On 
@ CERCTL 2 18004 
m= aTTcTt 1 38” 
3 MSACTL 1 On 
= GETCTL 2 on 
VIMGCE i 


In adaition, VIOMDOO, PARAMS and other system variables must be 
available to these routines. At minimums chunks 0-3 and chunk 7? 
must be enabled in the Home Sank. 


Locations 


This package can be incorporated into a machine code progras 
witNin the memory range from chunk & through 7, taking into 
consideration the remagping of certain structures when the second 
discley file is open. NOTES Machine code above RAMTOP is not 
acved. 


The routine SETMOGE CSETMDE) cannot be executed from a cartridge 


because of the necessity to enable the ROM Extension which 
disables the OGCK Bank. 
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Registers: 


Cther than #6 Gocurented ter output values, mo claims are aace an 
tc preservation of any register contents except for the I¥ 
Register whach must slays contain the value $C34h for sccess te 
tne standare systea variables. 


Automatic Serolling: 


Ae anatializes, test fer scrolling will be sace when the prant 
Benastion gees te the ment lane fellesing the botteor line on 
screen CBOTLNeZae26th Jane). Conaition Coe 3 (Screen Full) wii) 
be returned since SCRLCT will eecrement te zero. If SCALCT as 
Sot to some larger value, then the poreneters in SCRCTL oi3) be 
wsed te automatically ecrell the designated nunber of lines 
beginning at the specified line number. As Aimatialized, tnis 
will scroll the entire sereen up. By perterming » POKE or 
setting the variaples BOTLN and SCRCTL to the desired values, 
autematic scrolling can be aene using saaller sections ef the 
screen. when working from BASIC it is recemeended that BOTLN be 
Get to Line 21 C35M) and SCACTL©1 Be set to 23 C1SH) te aveid 
conflict with the Egit Line which uses the bettem two lines ef 
the screen. Note that ence SCRIiCT expires, it will be set to 1. 
If eo oifferent value is desired, 1% aust be reinitinlized by the 
user after receiving the “Screen Full’ conditien. 


By setting the SCROTL vardaple ance inveking the SCROLL (5CRL8) 
routine any portion ef the screen may be scrolled at any tine. 


Margin Centrelt 


In 60-Coluan Moges there are actually @5 character pesitiens per 
lanes The veriadle MARGIN deteraines the offset of the 
of the 60 celuan line free the left side ef the sereen 
walid offset values of Os 1 or 2. An offset value of 1 centers 
the 80 ceoluan lane en the screent 0 begins at the extreme lett 
Sides 2 terminates at the extreme right side. The default value 
in 1. when MARGIN 48 get te Op the varisble LINLEN can be set te 
G5 10 permit access te the 5 extra print positions. whenever 
MARGIN and/or LINLEN sre e@oditied, ao “Set Cursor’ eperstion 
shovle be done to insure the inteprity ef the print position. 


NOTES Since the eifferent MARGIN values result in éifforent pixel 
pesitions fer the colvans, care must be taken in mining 
line length and eargin values on the save line. 


ADDITIONAL NOTES: 


i.e 411 screen eperstions done by the System ROM CPRINT, LIST 
oar lane 170. CLS, scrolling, etc.) relate only te tne 
main Display File and work with Stonderd @-pizel vice 


eherecters. This geans thet every elternste 8 

Binels secress the screen vil} be affected. Yeu 011] vant 
%o enscute the Clear Sereer function in this seaqule te 
Guarentee that ne data in the second display file inter- 
feres Bith the use of & systee streen services ese, 
erior te doing a LIST. 


2. The COPY command w111] erint enly every ether grouping of 
0 pixeles serese the screen te the 20460 Printer, 


3. During tape operations, the Border will net change awhile 
in 80-column sede since this is fined by the herdeare 
te conforma te the paper cooler. 


& The SAVE fileneme SCREENS will seve only the main 
Displey File cata. The second can be saved by e SAVE 
filename CODE 26376561446. Be careful thet yeu have 
the cemputer in 86-celuan eedge when you lesd this 
Gata or yeu ofl] evererite the OS RAM reutines ane 
Screen” the systenlt (ihe count fer saving the diepley 
tile ie fer the data pertien enly since the Attribute 
File area from THOOM<TAFPM C€30720-31487) As net used 
by the video sede M7 in 80-Coluen nege. 


182 


AOL © ASC 002 BO-CCL.MSDE SUPPORT CHLOE voreton £6.34.346 le-mar-06 861233796 


1 Wand 204 ~ ASC 002 SO-CCL.NOCE SuPsoRT 
2 t 
3 8 
4 ¢ 
| 
4 t 
v $ 
eo 48 
ht Owesreecsosesescoccaocerocaceooeoss 
te e e 
aa t e Trmex e 
y ee . GPOLICATION CEVELGPMENT LigRaay @ 
13 8 s 
rt ' @ wanes $6-CCL.nG0e SuPPaRT e 
ast s e 
16 ’ @ a8C NON 992 s 
17 ] @ VERSIONS 003 e 
16 § @ aurRORs Ce. CONCTRAN/O. GOYLE e 
a9 i] @ garter 124 3 ° 
2 8 seoscesesesves oe 
az SUOTTL ORO IMITIONS 
33) C8 
a 4 
a3 5 eeeeOEPibITLONSeces 
we os : 
ar TwTAR WACHAR, UASTRG, SETCUR, SETATT, SETMSH, CLASCM, SCRCLL 
ae TmPeAwe CTCHAR, GETATY, GCETCUR 
39 $ 
36 PmT ER WECHAR, UASTRE, SETCUR, SETATS. SETMESs CLUSCHe SCOLB 
aa InTafm GTCHOB, GETATS, GETCUS 
,y ee 
33 raveae SaTedOe, SETMOS 
36 8 
3s) ks 
3e@ = 8082 fou a 126 LINES 
a” SCImg? tou A703" 6 SCROLL COMTMCL CML TEALTLATICN 
3¢ Corn? tou 18004 a CuGae SCHEER CTL. INIT. 
as Cnaset tow COCHMSPI~“160m> sCuae. Pas Lh-logH 
oy | Carns? eu CCCAPEPI“LGGM) § GRAPHICS TABLE 
a e 
623 Cmegvid teu Ogegn E ROUTINE TY Bom ONTENST Ce 
3 RECLEn ou irzo0 8 ROUTING th HOME AON 
ae 8 
as Liiiias tou Ore € WONG AOm ONT.SELECT PORT COLT 7) 
cc OnngeT tau ofan $ OOCR WOATLONTAL SELECT FOaAT 
4 i 
ee) vaes ecu Coan O SVSTOM WaRtaeLes 
ad STagre ecu sCegn 8 
se yes fou scram | 
$i Coargos teu sc7on t] 
$20 Pantoe tsu scezn 3 
33 eaant ecu 9Chan iy 
ga vronod tou ScCam a 
$3 «= PaBane tou sccin § Checation 2370?) 
6 Gatves tou 4esaw 4 
9? TMSERTSE toy TROOM<ORTVES 
$a MOVESE xu Oatves-so00n 
$9 = oes? teu GPPpenetavedzec, 
MY Lt @au OCstrT-saogn 
é 
o2 | (FT UTOL tov socen 


4 
$ 
i] 
t OSPOARAMETER THPUTS AND ENT&Y POINTS PROM BASiCos 
t 
? welts 
’ MOOULE LOADED 
' aT S7344CE000N) 
1 DECIMAL ADDRESS 
: eece ce cenecren= 
cooc’ 20 Oartas cere 20" a Cra. COCe PRIM Basic ST73e8 
ooo1”’ €3 OG3F° hl wa neat rld waco 1 RATRY TC wRITE CoamacrEeR $7365 
oeoe" C3 e171° ve wasTeas Pld WASTRO § ENTRY YO ueRITE STRING $7344 
7? t ‘ 2 Coee Panansd stove) 
ecoT’ ecee eo” 6G SWCeL cee t t SET Cursce pa eTeRs 
#1 t RENCCL COL. CO-79) $7381 
oz 4 LINMCOLOLELINE €0-23) 57392 
e00e* C3 0.84° a3 sercua: rid SETCHG 2% ENTRY TS SET CURSOR POSN, 5735) 
@ooc*’ 1600 as CLOCTL Sere ieoon t CLEAR SCREEN CONTACLS 
6s iy CURCTEGSTARTING LINE NO. 57356 
i 1 CLACTLOLOL INE COUNT 57357 
eoce’ C3 Care’ thi Cuasces oF CURSES § ORTAY TO CLEAR SCREEN 57958 
Oost’ «36 oe arrcvs tees 36n § aTTABUTE CONTROL $7361 
of : OIT PePLas~ (O IN #O+COL.) 
90 $ SOORIGCHTCG IH BO-CEL.D 
a1 rl $ 
92 1 aeparer COLOR 
93 4 bY) 
94 t 2 
9s ' de Ime COLOR 
ty { ° 
@032° «C3 O2F9° 7 sevarve: se SEvaso 4 Emvay To SET avTareutes $7362 
oo1s* 00 TY BSECTL cers 6 § mask COmvacy, FROM BASIC? s7303 
ad) ' OILY 2etaverse 
100 a Oacver 
@0160° ¢€d 0310° 163 Setusas Rid SETMAO § ENTRY TO SET mask CONTRCLS ST7366 
aceo 402 Gercre cEeeu @ $ GET” COmTaAcy Prom Basic $7369 
803 a PgemaT IS AS POM LIAWCSL 
Ca o320° 164 GTCmmet a STCwad § Enver To CHT Cuaeacres S73723 
€3 03c0° ios Gerate: oe GETAAG 5 ENTRY TO GET avvRrsute $7376 
C3 @300° 166 Getcus: rl GCETCHO F EMTAY TO GET CURSCR POSH. S7377 
ee 407 VIMODE oars e § VIOEO MODE COnracy $7300 
108 8 @onsanay 
109 4 Sato-CeramCo! 
eozs° C3 0301" 1300): SETmoes a STmOBG 8 OuTRY TG SEY VIOEC PODE s7303 
ooze° 61703 432 scects cee 370am 6§ SCHCLR CONT#OL 
an2 a SCOCTLeSTagTING LIWEe a3. $7390 
4a t SCACTLeLeLINE CouRT $7305 
oeze° C3 16a” ae scaue: Pld SCRLOO 8 Entey FO sCacis ST306 


iy 


20 
arene 
as 
Gier? 


a9 
1$ 
@ 
of 
48 9¢78 
76 
oc 
46 0031° 
46 GozP° 


033° 
os 


ooxe° 
aa 


2 ¢000 
9 


aa 
ose’ 
or 

ae 
osse 


t 
ecTun 


scaucr 


Cures, 
Gates 
Linen 
Cuevas 
3 
Graces 
masse 
t 
arrart 
‘ 
OTtnos 
‘ 
svaccr 
] 
maacin 
Srerr 


$ 
ancres 


5 
wacuaes 


wecrns 


watna2 
waCat) 


wecnte 
wacnas 


wacnz 


watns 


watns 


wacne 


SuSTTL OYmEe vee agrees 


37m 


Caeser 

Gaonse 
$On 

basan 


e8bon 


SUOTTL wezTe Cuaeacrenr 


uo 


cau 


ay6sarvas) 


Leecin 


26" 
ColuvPan 
0ata 

NC oTNVPAR 
ac 

ton 
CommCnnz 
90m 
Comecuns 
8Ce6u0G) 

8 

702 
weteayy 
oCZRTAu? 
60" 
wants 
OCoC Cran? 
IE emk 


MoCRINLEND 
NZ ouRCHIs 
a 

8 

Coa 

weceis 

a 


€ 

oe 
tetePuca 
oC 


sc 

La 
a.Cuagaa) 
Berk 


Cpwetnd 
8 


wz ,wItOR 
AeCoParr> 
? 


06.929 Pm 


184 


BOTTOM LIME CUINE aPree 
weICw SCREEN I$ CoNSIOEREO 
PULL. BUTOMATIC SCOCLE 
WILL 62 Gone I* SCeicT 

OOS WOT Geceeneny vO 6. 
SCRCLL COUNT © 1 SOLUS NO. 
GP VJees auromaric sCeeue 
WILt Of OCAE, 

S00M03S OF CmamacteR Tage 
GOCRESS OF STC, GRAPHICS TOL. 
Gime LENGCTHC OO 08 65) 
CURRENT POSITION 

CinTetnar eommary 

CUCRENT OLSPLaY PILE acoes. 
wasa Te 98 eLreo VS 

Crers 

Cueeeny arrareures 

COE aCe Ch uMITED 

TMSEN POR AOFUSTING 

CmeCOCe Ie CICMAR 

REMATHING COUNT PAlH wRSTRG 
wmtn “SCREEN PULL’ 

MARGIN BOUUST CO~2) 

OST POSmiTh LIMEC Fede 3e 8) 


MERE PROM Baste 
Cmuaa@acrtem west cose 


QnYay wif cooe tn @ 


$v3es 


$7399 


37393 
$7303 
57395 
$73%6 


s7see 
$7000 


$7002 
$7062 


Tmray TO OLSPLaY THE 
1S tn ‘Oates? 


LGA REGISTERS SOR CURMENh POSITICN 
OCOCURSSE POSITIIN FRGY “CUsPas* 


MECOTSPLAT PILE AD0RESS FROM *OPagRS 


BeCOOe FOR Cwak, TI BE OLSPLavED 


TES? vacr> aance 
< 20" 


> aon 
Save Cuasce POSITION 


TST IP ASCIL PRINTABLE C20N-7 PAH) 


res 
TEST 39 STO. GRAONICS(C EDGR M) 


USER -CRFINED GRAPHICS (90-ken} 


AOJUST AO52ESS<100" 
AOJUST PSR INORR CNTD Tage 


STO, GHAPaICS TABLE 
aOsuST FCM INCER INTO TAGE 


Cwamacrarm Taa.e 
CROPOSH. Tm OFSPLAY FILE 


Coom 13 teoae Info reece 


MLOPINEL PATTERN In TABLE 


CLOPLNEL PATTERN Im TASLEsMLOOe 


VEST If Gud OF LIne 


Svaavt op wo Utne 
QUAP LIKE 4G. 
LINLGhoLesTaay JF Ling 


TEST Lf SVaRt CF Line 


TEST (7 Past °BaTTGe’ Ling 


wERh TC PyY Cuamactee Ih OLSPLar PTLE 


CUASGR POSITION 
or acoeess 
GET Gvae ano Invease Ceontecns 


TP cORING maw INTO CL0 
Seok 19 BERING 90 8F NOT 


Conk POM SnveasSe 0G fF NOT 
S$Can Count 

SAVE $Ca™ COUNT Im ALTERNATE 
SAVE MASE VALUES 

SAVE Cram. TAGLe 4088 

Savé PrA.TS Stace 


e¢ao 
save 


3Cam LING Pace OF 
soomess 


TOGGLE TO ateanate oA 


TES? wetcm oF 

te OF2 

MEET QTTE 

ROA0 SCA% LIME PROM ALTERNATE 


SCANS TO whe LAST OF POS.IN C8 


Tas? £6 voven*® rd actrvg 


YeS-aevate CLO ara 
NO~ CLEAR CLO Oats AT Cran. paga, 
ate 


ae 
39 


La) 


oose° 
or 
ee 


2? 00 
06 01 


*¢ 


16 
19 


TE 02 
4a 
oo3e° 
or 
46 
#000 
oa 


o8 0028° 
e1ee° 


228 
230 


ze 


206 
aer 


230 
231 


233 
236 


236 
as7 
258 


260 
261 


wexta 


WERTZ 


WERRZ 


WERTS 


wat? 


watnat 
Goooae? 
enener 
t 
Ruvean 


U] 
v¥PuLe 


TePubl 


Lo 


rid 


z,aaat 


6 
€ 


a 
WEowenta 
Rem 

8 

Mee 

Mok 

€ 

bod 
&.coeerT) 
? 


Ltd 
&eCIE) 
MeCIKel) 
@otma) 
C.3 

ar 

a.8 
orcn 
O.s 

ae 

LIS 
2tewcen2 
a 


MZ eMERTZ 
aan 

iy 

Mee 

Bet 

€ 

ea 
8oC3Kod) 
a 


CT NOTMVERT 
@,¢Cbestt) 
? 


OC, OPC OOM 
Zemoeay 


ME owRCnS 
bad 

Lad 

¢ 


&,COPSIT> 


¢ 
COPRTTI.A 


Cel 
enaaey 


a, $casz 
6 


MC UPOPOSN 
a CSCaacr) 
4 

mse tveut 


ra! 
CECALCTIe& 
it 


Caaaer 
CECALCTI A 
OCeCSCACTE) 


scavo 


185 


WO NEED TS ADUUSTCCmaReSTamts af rf 7) 


SMLPT MASK °A° TEMES 
Co O°S $Taey av O27 1 Gf 8, OT 3 OF B, 
OR BLY S OF 48> 


SCAN LIN@ PRON OF 


RETAIN ADJACENT Cram PINELS 
CUBAR CURRENT CraRPTKeLs 


MLOCLO BEY ROW 
GET STARTING BST POSH. 


Save SCans 
OTR. TO Cuan ser 


SCAN LINE PROM CHaR.SET To OC 
COIREGS IW @. BITS Po2) 

Savi @ amO PLAGS 

OIKGGS Peow Cman, Ser 

LIMIT TO 6 PIZELs 


OasToee & And PLAS 
MESTCRE SCans 

WO SHIFT MEEOED 
CLeae Caray 

SmzeT Par Times 


SCam Ofom oF 
THSEAT/COMOINE NED CHae, 


OF KOR CH.SETodmL 
VEST IF SmvERse active 


MASK TO SuveaT 


Smzrv masse °a° Times 
IMVERT Ceagacren 


OF AORS. TH MLeSCan LIne fm OS 
WRITE $Céu LINE To cP 
OuTEQuavTe OF 

WAITE SCOn Lime TO CF 

Cuan.ser 

OvEasinveese rwOrcarors 
@OSTORE SCON COUNT 

wert Scan fn OF 

WERT BYTE 1m Coan Pie 

TEST 87 aCRE Scans 


Ta? saw in CF 
Cut$o8 POSTTION 
ASsuST Cugsae PasTticH 


S59037 BIT POSITION 


STCRE UPCATED POSITION 

WERT Crate Sane OrTE 

WEXT Coae tu ment OYTE 
STCRE a0suSTED vacur 

S0JUST OF ADRS TD mEeRT ove 
TOCGLE 15 ALTeanate of 


TEST anitcn oF 

Dome 1° OF2 

Mex? orve In 071 

STCHE MEM POSITION 

MeTURe ~ACed 

GMTER MERE WITH C MOWOTERO 


RETURN OCol POR TmvaLIC PaRamergas 


Test 16 mew Lime 23 OFF scereN 
bepine wd. 


§ Save tw 6 
He elas 4 Gat OOTTOM LINE 


Ow SCREGe = RETURN TO BATT Cuan, 
WIA UPDATE ANC SToRe PCsITION 
Vest SCACKL Count 


OS QUTOMATIC SCROLL USING SCRCTL 
QGlalrianrz@ oO 8 


OLSCAAG @etuen TO warte Curae, 
METUAN OCey POR SCHeenm PULL 


VOOsTE vaaTagLe 

Get SCROLL CONVOCAS CETARTING Line 
ano LIWe COUNT) 

RETURN TO WATTe CoaR, via SCROLL 


eica’ 66@f 


0042° 


o3 
v2 
ao3s° 
63 
oe 


2 
ee 


46 007° 


eons? 
o4nce 
osor? 
o1e2° 


307° 
@1 

Olere 
ae 

aaere 
eseee 
0102" 


1s 


osse° 


wRSTRa 


WRSTRIZ 


astaG 


wastes 


UASTHS 


WASTES 
' 
wOsTasG 


‘ 
i 
‘ 
' 
setceos 


t 
SeTCuRs 


$ 
Sscauecr 
3 


' 
scecues 


f] 
scae 


Testao 


SUGTTA WAITE STRING 


40 B,C OaRane) 


ano 1s 
oa oon 
40 Oa 


Lo ML eC VARS) 
40 Ao €-4) 


ano | (OTeH 

ae LesssTeg 
ce r) 

aan z,Wmstaz 
Pusn 08 

CALL RECLEN 
ax Ober 
Pop ook 

an wasrai 
Tre ML 

Lo CoCo? 
rnc ML, 

to B,CML? 
mac 

4o ast 

on c 

eer 2 


to AeCmnd 


Ouse mL 

Pusm 8¢ 

Caku waCuaa 
iy] ae 

oa 8 

Pld MZ oaRSTXE 
poe ac 

oar Ls 

Tne mt, 

oec | 8 8¢ 

to at 

oe c 

at MZ oMaSTAG 
eer 

to aoc 

ce ry 

Ja rewasrey 
eon om, 

40 CSTOGCTI OME 
eae LTS 

oO c.3 

40 80¢ 

eer 

to Co2 


an wastaz 


SuGTYE. POSITION CONTAC. 


LO OC e CU ENCOLD 


Cae = rstean 
Cal Ccaven 
CAL = uP POtN 
we cce@oeer 


Suerv,. sceour 


to «eC, Cscaety> 
ee 

and a 

Pld ZetmvPan 
apo aye 

cm 4 

a Cokevran 
cp as 

sh MC TUVPAR 
cana sceuo 

oo Gocoeer 
Puse ac 

to Mo SCRSE 
sus ¢ 

60 Ora 

4&0 Se CUSALEN) 
tac 4 

4o Cea 

CALL tae 

sore = =68c 

Ousm OC 

to Got 

and 4 

oa 2,Stecn 
mca 

acca 

aca 


MERE PREM BASIC AntRY TO 

WRITE CHARACTER STRING TG SCREENS 
STRING TOENTIPIER ¢ cooe) In 
SUSTEM VARIABLE Pagaus aT SCC3H 


MASK CPF UPPER SITS 

STRING VARTABLE [OEmTIOTER 
Save In 0 

PINS STRING 


Test £@ ENO CP vas aged 

WG FIND © RETURN BCeZ 

rest 2° marTcn 

POUND STRING 

SAVE STRING 10 

AETURNS BORS.OF WEXT VAR.IN DE 
aoes. TO mt 

Restore Svaras to 


GEY LeNGTn 


#TAST Tex? CCOE 
TEST I NULL STRING 


RETURN If $O 


QNTRY PROM MACHINE COCOE WITH 
MOORESS OF CHAR,CLIE “STRING” 
Th ML AND LENGTH IW OC 


cev cooe 

Save aOn$. ano 
Count 

wWAITe °a° 

vast r° Goce 


Qxtv 1f Iwvatro CCOE ae 
TP SCREEM PULL 

count 

aooness 

MEXT Craa, 

aogust COunT 

Test £P OcHwe 


WRITE MERY Curae. 
ReTuan BC0d 


SAVE GRaG? 
TEST EF UNRECOGNIZED CCOE 


CONT tnue 

Pewslwins COUNT TO wh 

STCRE REMAINING Count 
a00R!ss TO m 

RETURN BCoS POR SChetN PULL 


RETURN BCaz TF STRIinG NOT POUND 


MROE PROM BASIC ENTRY. PARAWETERS 
Im Linco. 


GmTAv wit GINECOL. Im BC MEG. 
TEST PARAMETERS POR VALIOITY 
CONVERT TO SNTEANAL PORMAT 
CALCULATE AND STORE POSITION 
AeTyuRn aced 


MERE PROM GASEC OntRY to SCROLL 
Scectn 
GET CONTSCL IHPO. 


MERE WITH CONTPGLS In OC 
Gand. OF KLTNES 
CosTARTING LINE WO. 

TEST VALIOITY 


@anan 2° Counted 


PRHOR TF BOCK) 


@GROR IP BeCd24 
oo scacu. 
aeTuan 8Ceo 


GET STARTING LIME IN INTERNAL FORMAT 


Cor. 6 


SAVE GRIG.8C POR EXIT 
TEST sf at Staev CF LOCA 


ves 


40 Cos £ GOT NG. OF LITmES Pers B.Oce 


ce uo ase 
sus o¢ 
iid 8 6 TEST AGAINST TOTAL LINES 
tle ae CeGatue # TOTAL Gagavee Weim Tats BLCcR 
tasoore 
eo & @EMATHSRG COUNT 
coe 8 Oeulnes ters s.ocK 
oe  Coscan Count 
core 
$ Save SCaw Count 
§ CaccuLate wo. GF SvTEs 
00 8 BCedzes OF LINES 
Looe: 
oFt0 t GET 2085. GF PeRY. LIne 
3 Te of 
2 Save Count 
@ Save apoeess 
06 § 00 move 
or a Tesy fe os 
os Jf mr marse ' 80 
ao oe 20 
LO wea 1 Bo OF2 
@a ial voces 
oe MaTSC = amd ODPM 6 Gace TO OF) 
i) Lr 
twt of 0 mex $Can Lime 
Por aC 2 $Cam CouaT 
oec ¢ 
oa aa ur,49000 1 MCRE Sans 
oor ac O ROSTOUAL LIne COUNT 
40 st 
ono 4 
04 oe TsSCOuRT § Bone 
00 £0 bed 3 STA@T CF wet LOCK 
sc ja) festag 100 MEMATNING LImECS) 
$01 $COuRe PoP aC a OAsG.aC 
$02 to acd @ SVaARTING Line 
963 400 448 $ 800 NO. OF Limes moved 
900 oec a 8 Last Ltme SCooiLeo 
$03 to Coa 
61 $06 oe Oo 1 CLs 1 Line 
$2 He aa cusscoe a CLGae VACATEO KImEt ANG BETURN 
06 a 
soe oaeie o Coa 
$10 4o 4.0 
$31 tue ¢ 4 A0dUST TOTAL L2we COUNT OY wo, 
$42 to 6.4 5 OP LIMES Burs Loca 
943 fuse ec 
Sia to et 6 L046 2 mo, GP LINES Tks BA6CK 
eo gis oy ee 1 Ld 
gia ot 
$i? STOUR cec 4 8 aSuuil TOTAL LINe COUNTol 
$16 Pusm BC 
oe $19 ao C.e@ b 8am Count 
$20 «| STHLAC PUSH OC i Save 3Can Count 
$210 SVOuea On Ob sma 
Pete $22 to Meee FIOM 
923 aoo mot 
$26 «x Obom t AORS. OF PREV. LINE 
0020 523 Lo OCo32 § GYTE COUNT 
$26 PUSH MK 
eo $2? Lore + 00 Nove 
$26 Pom om 
$29 to Aen 
ow 530 ort) 3,8 
05 $31 an WEeSTOLK2 
ri) $32 oR 20H 3 BO bF2 
$33 Lo Hoe 
ft) 536 a STOUKS 
on $33 STOLRZ 68ND) (DPN 1 9ACK TO OF; 
3 Lo Web 
$3? Tae 4 $ TO wExt SCAN LENE 
$38 oor oc 
$39 oec ¢ 3 Tes? 27 mcrke Scans 
eo 568 a MZoSTOLRO 
$41 bop 6c $ REMAINING LINE COUNT 
$42 to 4,8 
se) ano 8 
ce gee aa ZeSCRLUXT 
Pe20 ses Lo Of s-TEOM t aQsuST TO LENE 1 
Ses 400 mL CE 
o1F3° Se? Pld res7vao 3 SCOLINE CSunt 
see t ML80F ADOAESS 
soot 
gs. SUATTL CLEAR SCREEN 
$328 
$53 $ 
396 = CLASSO! 4 MERE PROM BASIC ENTAY TO CLEAR SCREEN 
68 000c*’ sas to OCeCCLAC TLD # GET Contec. Info. 
$36 a 
$S7) = CLASCHs a Guay WIT BCeLINE COUNT AND 
$38 @ STARTING LINE WO. FOR CLEAR 
350 to a6 
560 and 4 a Yes? vaurorry 
O1er? sel Je Fe TN RAR $ Eaage 16 Counted 
562 405 as€ 
0 $e) ce a 
O1er? ry} Sh Co Shu Pan b BeROR TF Boles 
19 Ses co 28 
one?’ 3o6 3m mC otuvena § ERROR TH OoC>24 


187 


Cata cuasco 
Pid eocoae? 


Oo service 
RatuRh BCeg 


i 
CLASCO PutH aC 


cs 
be te to Mo SCRSE 1 CONVERT TO INTERNAL FORMAT 
o. te Aa 
a? 5 ° 
ga 00393° ub MoCUSwetn? 
x mmc . ‘ t 887 TO COL 
ry ' 
co osye* cau. tney t Ger aooRess 
30 0 58 
se to QC 4 Save POSITION 
. oar ac $ G86. OC 
os Sutn 06 
vo Cuescs 40 Mot 1 GOT © OP LINES THES BLOCK 
or aca 
7 aca 
hj aca 
a 10 Cea 
seo8 10 ase 
3 sus 4 
ae ce 6 ( CoMPaRe 0 TOTAL LINE COUNT 
3a 30 ae CeCuese? 
me Cuasc2 t MQ. OF LIMES 
$e 00 t REMATNING LIMES 
cs 
a? cuescs 10 a, 
oa O60 to Cee 1 $CAN COUNT 
6 Cuasce 40 4.6 
cs Ousm 8c 
te 07 and ’ 
oe #aca 
or aaca 
or acca 
or to Cot 8 SCeS2eNO. OF LINES 
06 06 to 6.8 1 CaO ITP 296 FOR 8 LIWES) 
00 pec ¢ § aosusT 
cs CLascs PusM Oc 
es OUSH mE 
$4 oO Deo 
so to got 
34 00 to Crk 2008 $ Cugarm OF 
13 Ince 
€o 8o cor 
@ Porm 
C1 ooP ec 
ia i5:) aon 
cea oF err Sa 
20 665 se NZ oCLASCE 
Fe 20 oR 20” 
or to Wea 1 50 OF2 
160 &8 Ja cuescs 
te oF CLASCE aNd Ooh § RESTORE OF3 
6? to Wea 
a4 Pils “ t WEKT $Canm ROW 
rat pop at 3 POP SCAm COUNT 
oo oec € 
20 08 cli WEoCLRSCS 
C1 oop ec 1 TOTAL LIne COUNT 
ve Le hed 
ar and 
26 05 ae ReCuRsn? 
z€& 06 £0 bet § MLOSTART OF NEXT OLOCA 
C3 o2a3” rid cuescs 1 BeREMATNING LINE COUNT 
ca Cuasxt oP ec $ POSTION 
C3 osor’ Fld uPOs0sN # RETUQN WEA UPOATE AND STCRE POSITION 
oF cuescy 40 Cos 3 SAVE NO. LIMES THES 8LCCK 
7¢ uo aot 
L2} aoe $ AQJUST TOTAL LIne Count 
oT t 
cs Pusn 8c 6 REMAINING LINE COUNT 
78 to aot 3 LINES Tels BLOCK 
ae ee se cuascs i] 
SUGTTL ATTAIOUTE CONTROL 
’ 
iy 
t 
sevacos @ MORE PACH BASIC Batay To SET ATrAzeuras 
ga 0921° to eecarrcred. 4 GET Conrec. Ineo. 
4 
Sevarts 3 EnTRY UTm ATTAIeUTE BYTE In & 
te 07 ano 67? 1 Get Ine SELECTION 
ae LO Cet Save 
3a $CC2 nr as CurOnco? € TEST 87 OF2 OPtn 
ar an a 
Ca O107° ld ZelhvPae 2 ENVALIO £6 OF2 NAT OPEN 
ih] to = ae 
uw aua 
Ww aa 
u? aa t SWEPT TO ase POSE TION 
*s Pusm ap a SAVE MOTATES vaLUE 
a 06 oa 4 t $8f “se mace 
o? to Goa 1 WaLUe #08 asw 
oe ve In Ae CmREKPT) t 
te ce an) OC Om $ PRESERVE SITS 7 AND @ 
90 on 6 t Sat viICto nope vauue 
os ve Out (MAEEPT) oS t Set nsw 
e 40 oR = 40n § veoate vrongo 
ba 9€C2 to CVROMGO) 54 8 
crt Por af S$ INK SELIM BITS 9-3 
2 cm $ GET COMPLEMENTARY CCLOR 
iF OR € 1 COMBING ult RAR 
32 0039° Lo Carravry,é § Save Im vahTasce 
€d O202° se =6coaoRer $ @ET IAN 8600 
f] 
a 
t 
e310° Satmeos ( MRE PROM Basic ENTRY 10 Sev nase 
310° 9a e018’ LO AeCeSRETLD 8 Ger CONTRCL INO. 
8 
9320° € setusas 0 @HTAY WET MASK VALUE fh A 
0320° 32 OC38° 10 «= Cmasenoya STORE MASE FOR APPLICATION TO FUTURE 
0329" C3 Ote2° a ecgeeer t OrsPrars 


188 


' 
s 
ercuees 


o3z0° «8 68 0019° 


i] 

Grcmaas 
osza° CO O48 
0320° Sa cexE° 


o33s° CO Gener 
o336° CO osec? 

to 38 Go2e° 
oe 60 


orem 
Gena 


ca 0940? 
Grcwaz 


GTCn23 


Grens 
orcwss 


ce 340° 


Giemsa 


$ 
Crewe 


TENS 


SUGTTL “GAT ROUTINES 


oc, ccetcred 


rstese 
aeCCFSET) 
as 


coeetn 

Ca coos 
ge, centes)d 
8,06 
a,t00 
COTINGAD |S 


WERG PRCR ASIC Entay TO Get Cuakacres 
CRETUENS COOR 998 Cuagactee af 
OOSETIae SPECIFIED Im GETCTLD 

Gar Comvace Ine. 


Qntay were Postvign ts 8¢ 
ves? 6 ans 
Save Cuneeny OfF SoSstTIoN 


Convent To CMTeQuay Poenat 
O38 avO Ort OSs. 


| 
NQo OF POZMTAALE Cranacrers 
Se? adsustuant tnces 


aosust 70 STaay Ge TaeLe 

Save Causes 

Sav@ 40a$. Ih OP 

Sav@ AORS. Im Crake. Tesre 

Ce? $Caw LINE PaQm GP TO C86.8 
SITS 2 


@ ests t9 6 


8 Cuae. Se? ofa, TO me 
& POlze. Rew 79 4 
8 mate TO 6 BITS 
8 TEST aGalnsT oF 
a matte 
8 TEST LF LOGREne AT STO.GRaPmtCs 
abeatene? 
OTCwe 8 OG WOT TEST Iuveese f° STO.68. 
as 
orchs 8 TEST £7 mavcw Om Invense 
WE oGTCHO 8 O085 NOY aaTcr 
Coa 6 CaO FOR WATCH <6 POR InvERsE 
Oe? 0 $Canw CoueT 
Oeam 8 OF a08$.TO m 
ac $ SAVE MATCH ANO SCAN COURT 
" $ MEX? SCAN Ih Of 
oe $ went e@ tn Crae.set 
Grczec 8 wan’ $Cae f6u T3 aC 
6,8 
a9 
6,8 t 
Otom @ Cnaa.sa? PTA. TO me 
&eCme) 6 Cnae.$e? aCe 
orca 3 nase 70 6 OTS 
J 8 TEST mates 
ec 8 GET PRv.HaTCe And 1C4N Count 
¢ 
ws eGTCKe BS HQ MATCMoSTART aCatn GF Neat 
efCass € 90 meat Scan 
aot 8 howe [8 WATCH Cu tnvensE 
a3 8 Sav 70 -2 27 merce Om Invense 
it4 6 MERE LF MaTCHm CSPDePTALTO Cree. 
o¢ 8 Tm TARLEICSP ORCC elm OFF 
ec 9 €SP0a,eCwan. Count 
Coa 8 BeCouNy Cog LF mayCn Cw teveRse 
OoCETinex> § COnveat maven fa Cwae.cace 
8 
ton a TEST 20 march cw seace 
NE eCTCHI2 ad 
¢c @ TEST Lh waTCe Ge LuveRse 
WE oGTCHSZ : 
a ie LG80 COOE FOR GRAPHICS BLOCE 


aot % 


Ae CGPINGRY 
ton 

MZ oGTCHS 
OG eCGRTOLD 
O,ae 

a, 909 
crews 

sou 

WR GTCHE 
Eeesues? 


189 


RETuan Bm REE. C OF OC Pate 
anQ tn G86. & 


austere peat 
€nae.cooe 70 A 


Th, TA Cue, SET 
MOVE Oe TO neRt Cnanacten 


oF aconess 
Cran, Count 
OUCREMENT CrAG. COUNT ANG LOCK AGATE 


TAS? &P CONE 
TES? IF STO.CHe.SET 
TRY CRaonics 

& Gaspmrcs Taare 
WO. OF ENTATES 


TEST LF STO .Gaamnrcs 
FAY USER-ORPL NED GRAPMICS 
MOUUST ADOAESS-3008 


NO, OF QNTOLES 
Moen agaus? 


HQ MATCr AT ALL 


e3ce” #1 ote ooe ap § RESTORE ORG. CFarT 
eacr* 32 0038° to COPBITD A 
oscar 46 oo Cod 4 6Cee 
oscar a nor ob 1 ace 
escc> ce eer 
3 GET atrateute Syte 
1 MCTE Treat Im SO-COL.POCE ALA SCREEN POSITIONS 
D MAVE THE SARE ATTRIGUTES, Tmewercae IT 34 
8 MOY MECESSARY TO USE THE “GHTCTL® SLSITION 
U DaGanereRs 
‘ 
eevsgos 6 WERE PROM SastC ENTRY To Get atrereure 
] 
3a 0039° GETATTS 46 «Ay CATTOYT) ¢ GET ATTRIGUTE BYTE 
oo LO Cel 1 Pur In Oc 
ee 66 to O66 
ce oer 
: 1 GET CussoR POSITION 
Gerceos U MERE PROM BASIC Entay 
Gercues 
€0 48 036° to 9 ac, ccuaros) 4 Cet Inveenar POST TIEN 
co earce Cale COmven 41 Convea? To USER FoemaT 
3a 6033" uo MoCRSULEND 1 TEST 3° Guo OF LIne 
69 ce € t I o@¢ Of 63 
ao of ae M2 eGETCS 490 
ef 06 uo Coo 8 MEET OOSW.START OF WEZT LIne 
v8 GD eB 
xe Inc 4 &§ BUMP TO wEET Line 
ay 8 Gea 
ve 10 ce ae t Test 1° Gee Scaten 
38 62 SRC oGETC) ay) 
Os 37 40 6.23 § POSnN. 13 GF BOTTSM Ling 
@c& 43 coor’ Gercs 6 CUSNCOLD BC { STSAE PAR BASIC PROGRaDm 
ce eer 3 VALUGS ALSO Im 6C 
r] 
SusTt,. vzo80 mood Convec. 
‘ 
3 
@nes° Svapes: 4 MERE FROM ASC ENTAY UItn BOOK tw 
§ °wrecoe’ 
@ses° 3a e826° CO aelvEncog) 
] 
6300° oe 1 Gnvey wrta moe In A 
eaee° af and a 
eases’ 6236 «PF d& = -BeSEVMOL «6b TEST POP weLtoRtY 
eser’ Pe os co 8 § @ose COL.mOcE 
@are° Ca e147’ JP BB TUVPAR 67 TuVALIO PamameveRs 
t 4 
f] ) 
LO MR SCIMIT 8 EHITTALTEE vaaraeces 
40 CSCOCTE DML § SCOCLL COnTeo. 
ao &o2) ‘ 
ao COSTLMD.A 68 COTTON LIne 
40 Aet ’ 
to Csceuct),4 & SCACKL COUNT 
60 «4.80 ‘ 
C0 CUSMLEND 6 1 LENE LENGTH 
40 0 fel ‘ 
LO CMARCI NDA O MARGIN 
66 mecCUINIy ¢ 
He CEOSETE I ont ¢ Crean Steger Contag 
£0 CmaseO>, A 8 masa BYTE 
ao CETACCTD, A 2 WASTAG MENAINING COUNT 
60 «CStecctoid.a § 
6 meCmOser § STO. Coat, Ser 
£0 «CCmtanreme 8 
CH = HL pGAPMST 69 STO. GRAPMICS SET 
: Cy CCOTOL Dems f 
t 
; O SMITZALIZE BASE LnPuTE 
] 
to COaTasc.d & CATA OTE 
GO CUENCELD 8 1 CCL URN 
as CEEMCEe ode 8 LlmE 
LD CMEC MEA F MASR CONTeDL 
0 CGOUTCTLI A 6 GET? COL. 
C0 «CGRPCTLORD,A 8 SCOT” Line 
0 ace SUT mse 7O es-CCL mone 
Sateo.r 10 Goa ¢ Save acoe 
to AsCVIONOO) 
6nd 4 1 72S) CumRent aooF 
et mI servos 
oa 1 CutRtny modged FEST LF mew ROCECO 


8 
Sha BeGoosenr ff ReTuaN OCe6 
5 MhotmSEars? 
to DE MSVESZ 


40D MLE t MLeTOTAL RCOM NEEDED 
$e sces bo OG eCSTKRENDD 

19 aco mL DE 1 ADO MEMORY IN USE 

Oa Osan? a CoEXTNAM 3 NOT ENQUGH MEMORY TO CPEN 0F2 

€o $8 sCcaz to OE, CRAMTOP) 

ay ano of 

€0 $2 sec MLeOE 

02 Oear’ ‘Td NCeENTNRM | NOT ENQUGH MEMORY 

CO o40z° Sermoz CALL GNM EXT 3 ENSBLE ROM EXT, 

7 to rh) 'NCOE TO & 
0468" CO O4ace CALL GeTvaL Meu valu@ TO 8s VICMOG VALUE 76 C 
aera’ C3 Pusn 6c 1 Save 
oar2z° 78 to 4,8 


CALL CrmGvrIG 1 CALL RIN. TO CPEN/CLOSE 2N0 08 
CALL ENBinOME $ REENABLE WOME BANK 


@erer C3 oe ac 3 VALUE POR vIOsdD 

osTae 679 to aoc 

@erae $2 SCC2 to C¥I0OM00),03 UPDATE vIOROO 

oere’ Ca 77 oT ueoare BIT Goa. 3? UPOATE SYSTEM VARS. SASEO On MOOE 
O600° Ca Q162° 908 Pld TeGOoORET + DONE IF MODE O 

oo63° 38°61 999 $xTe to a,CCin § 66700-CCL. COP 

008s" 686 900 aa 6 4 STORE ATTRIGUTE BYTE BASED 

oeee° = 2F 903 cm 3 Om INK SELECTION 


190 


3e 902 sau 8 
38 903 sau 6 
38 906 sau 6 
90s oa 8 
oo3e° 904 ao Cavrert),& a arrersyuve syvrve 
ool" 207 to CATTCTIo& { SASIC Parameter 
0033° 9c5 oo Ge CUINLEN) 
709 TNC 4 
910 to Coa 
, 10 oni to 6,104 $ BCawOme POSETION (iN.0760L.0) 
0000 912 to Mbed 
scro 913 to CCOOROS Dome 4 PLOT POSITION 
essr° ore CALL uPOPasN 2 UPOATE ANG STORE KOME POSETICNH 
O402° es Pld socoeert § METURN Bed 
02 $16 0 «0 fxTnae 640 Cod 3 RETURN BCe2 FOR WO ROOM 
O2ee° or ld ereret 
o18 ' 
920 SUGTTL ImTERNAL SUB-RINS. 
ors a 
ozs 
923 ‘ 
926 3 INPUT? VIDEO MOOe CN a 
e235 1 GUTPUTE mew SETTING tn a 
926 t VIOMOO SETTING IN ¢ 
HH 8 RETURNS NZ STaTUS If MODE INVaLIO 
2 t 
929 t VAerO vavuest Inout wee vromao 
030 i eonnn woe wenace 
HH t MOOTSPLAY PELE ACTEVEe af SCREEN 
3 ' 
933 t OFl ONLY 9 ¢ qo 
93e ' OPies OF2 eo -@ oo 
935 i OF1 & OF2e 8 3 1 
936 9 MEGH RES.GR, 2 a 2 
937 § 66780-COLUNN 06 - 3E 06 = 38 46 - 18 
o3e Gervas 40 Coa 
o? oof arr O58 
6 940 Je weetsroa 
oat ce Gon 
Oa? 3a reseto 
943 err T,a 
crry navy owe 
eas .o 0,8 
o2 946 ce 2 
4? ne? zt 
ce 948 and Ocean 
os ose nok 6 
ose eer ng 
40 esa to 4e4Qn 
952 gr € 
asa 40 - Cot 
O56 wor a 
95s ner 
or ose wsroL ce i 
os? wer ng 
On 936 to $e 
a 959 40 Co@am 
9400 acr 
ool sete wok a 
962 uo Ooa 
903 eer 
966 1 
965 t] 
eae U MQUTINGS TO ENABLE CHUNK O In RQm ext, 
wer $ POR ACCESS TH CunGviO ROUTING 
908 QMSLEXT PUSH ae 
oP 968 tH Me CmQExet) 
80 70 or 80" 4 SULOCT MOM ExT, 
oe 971 aur CORERPT GA 
03 9T2 to aed 
ity 973 cur CORmSPT DA 
9Te oop ap 
ors aer 
o16 J 
gv? CnBLncme PUSH AP 
978 age a 
% ere Out coRNSeT)A 
Lda 980 tw Bo CMRERPTD 
bid oa and O3Fa 
ee oaz OUT CmRRKPT)»& 
es) oe AP 
aer 
' 
2 TEST PARGNETea vaLIorry 
$ TP WOT VALIO, CISCAROS AETURN 
O OWO QUITS VIA Invoark 
ar 909 Tavrpan 610 Medd ao TEST Utne >2d 
990 ce 6 
oe 991 aa WC TSTORS 
9ez arene POP aP 
Oser’ 953 old Inveae 
6033° Tsvpar 40 @eCLIALEN) 
OFC a 
ce € § TEST COL. DLINE LENCTHAW3 
$3 a CePangar 
eer 
$ 
9 CONVERT KLIME/COL. PROM USER TO 
8 tar may BNO VICE verse 
t uses 2 OSMBS 0-23 
4 Clu. O-79C 84) 
$ TnTeenay PCamat: 
8 LINES 24-3 
$ CBLe €OG)81-2 
t 6COL.3 Guo CH Utne? 
i | 
a t 
eerc’ 38 6033° a0. Conven 16 Mo CLIN END 


191 


sue 
te Goa 6 Couveay ! 
vo ao8tasz 
sve 8 
ce Oot 
eer 
4 
’ 
esere wroveses euvee mene uTve eCerteesce.tw 
BePeRway, Cpenat 
aser’ Ce esace Cae «can Cras CALCULATE OGSIT16N 
een’ 86 46 a etoasn STCHE WODATES POSITION and eETURS 


QOvTint VO CacCwste POSTTIoe In BF 
wpoates OFT SBSITIIe tm wae sAOLe OP OTT 
Qetuans OF ANDNNsS fe H. OMESEdvES 
2067604 PESET ION Sa OC 


GET OSPLav PILd 2OAS.PHe LINE. 
TEST wntcr OF 


OLCPOS Cana = teeu 
SoC hANLEN? 


O GAVE COL MO. COKE TUL ENod dD 


"5 2 DOCOO-COL.9ES.> 4 4 © bb—CCL PES, 
” 
at 
ry 


4 000 Cors.nee 3m 962 


a6 &,204 
* ¢ tm epa 
of 
ae 
Cauces a @ Geese Caney 
a 6 COasd Bh POSET3E0 fe OrseLay PILE 
e 
0090° o.cmbecin) € GOT adsusreent vacue 
act 
€.a 
oe O08 4 BG Confatns GrPseY wre Line 
‘“ ad dm COnTarNS Be apoeess 
7 : 
; - 0 MeCEL.PCSN.POR 86 COLS. 
e t 
oa Becarers a staets at ost 7 
QA @ Stents af O2T 2.3 Of 8 
a 
eose- aerene tsrertoee 
¢ 
> Clmans. meee seceess 
t 
1 
espe tmaus 8 GET OFSPLAY PILE adoness 
@ POR START CP Utne Ih 6 
ae ue co a,scesz 
iT sue 6 
9? Tn Ges 
oe a 
or aaca 
ee eacta 
fe e¢ 2 and ofan 
oseee oF LO bel 
oseoe ota TT) 
osear @6 28 and 16h 
eset’ #6 466 oe On 
sen 67 0, Wel 
osere ce 
osso° St9OgNe + SYOR@ CuascR POstTrON 
390° 82 43 0030" LO ccouRPcs).6c 
@sse° 22 6036° LO (ORACRSD ML 
oss7’ ce aur 
: ; 
osse° covcsms t Lose CuRsa® PostTron 


LO OC,CcuRros> 
£0 MLyCSFAORS) 
aay 


@550° GC 6B 0036° 
@9sc° 2a 0036° 


: 

8 

i 1 RTH. USES BY GTCHAR TO SUT 

8 5 @ PERELS PROM OF to 8 REGRETS FH2 
8 # POR MATCHENG AGAINST CHAR.Sef 

8 
6 


Te28C Ouse OL | Sava OF aORS. 


ir) oe BeGu? 1 SCAW LINE PROM OF 

4 ue Ayn 

at 20 xoe 2g" 

67? to Moa A 1 TOGGLE TO auveawat¢ oF 

ca oF err Sos t TES? water CF 

26 63 an WE oGTC201 

a3 tee 

of GYC383 LO CoCmt) £ OC CONTAINS CHAR. AT OFSTT 
3a 0038° ia) aeCe*err) 

te 07 sue 7 

«do 46 nee § Aend.OF BITS CFPSET En SC 
ae 07 aa 2e6TC262 § svaats av oxY 7 

co 33 GrCyneT a c 

ce 10 % 6 § Sule @ IRELS POR CragacTER 
30 one Of 6 TO Ge S78 792 

26 #9 a WIeGTCSHPT 

a etczaz 908 , me 1 

cs aer 6 CHARLEN By BETS Foz 


InCLuoe Castes 
SUBTTL Curae. SET FOR 40700 COL MOOES 


192 


4121 
3122 
4423 
3826 
1025 
ite 
aaar 
4128 
3129 
1130 
alhi 
4432 
4133 
aise 
413s 
1136 
4137 
ange 
3350 
34100 
iti 
1142 
the) 
dies 
lies 
4146 
aner 
lies 
1308 
aise 
aug. 
3as2 
a9) 
ise 
iiss 
tise 
aus? 
1158 
aise 
3160 
1163 
1162 
ies 
2346 
1168 
3166 
sae? 
1166 
3169 
arte 
aati 
air2 
3173 
auye 
ars 
1itsé 
w477 
ante 
aire 
3380 
4161 
3382 
418) 
43606 
3385 
Al6e6 
aie? 
aaee 
aaas 
is9¢e 
angi 
1192 
2193 
1396 
1393 
£196 
aie? 
4196 
aaes 
azec 
2261 
3202 
2203 
1206 


120s. 


4206 
1207 
3208 
1209 
3249 
azar 
3242 
4233 
4226 
1235 
2236 
ag17 
azie 
a2it 
4220 
2221 
3222 
3223 
122¢ 
4225 
a22¢ 
sa2t 
3228 
1229 
3230 
aana 


a 
6 Det setternsa fer characters on tne TY screent 


éefo 
dete 


cuagt 


O © writes 


tor with ¢ 
3 © vlack, 
wertically er 


000700008 
996259090 
600533000 
0909375008 
000555008 
0905530008 
095992000 
eoococddn 


oocacsooon 
00035900e 
000339008 
006109008 
000169008 
oooc50c0e 
g001C000b 
020395000 


0009399008 
910310008 
0103129000 
g00cc3008 
Q3C053008 
930030000 
900000008 
900000000 & 


ao 7cs0008 
Ocrcrs0oe 
0131113000 
0016190008 
OO1510000 
Orsartdoe 
6016253008 
000005008 


o0c000008 
Oo0tscooOn 
OVsitdve 
Gtcas3008 
O2L1221000 
COCTOL00n 
OLITIIGOD 
090195008 


SoC I00b 
O110C1008 
011620008 
Orl1coode 
9301 200 
09492100b 
QASSRIOOD 
e0000csGe 


900050008 
000200008 
001010008 
Goc190008 
G01021008 
016010000 
801191008 
oo0c00008 


ecoto000n 
000100060 
003029008 
OOCa+9008 
06000000» 
000630008 
o000s000n 
e00550008 


eocTH000e 
000319008 
000250008 
000200008 
6001-9000 
600150000 
600520008 
000300008 


eoccscote 
O016 70000 
000359508 
000150008 
0002300008 
600290008 
901060068 
900030008 


000900008 
GOCOOCO0s 
601070008 
000369008 
0113213000 
000100005 
002029008 
e00030008 


000620000 
b00C00008 
0905539590 
. 
O22832000 


18 at offsets Ctee lined te Sue? Coetter line) 
FO Fer_aLne cCeteeen character sgeces either 
norazontaliy 


3 code 20 enace 
1 ce¢e 23 $ 
t cose 22 = 
1 code 23 s 
t code 26 i] 
| code 28 ' 
1 cede 26 6 
4 cede 27 ° 
t eode 28 ¢ 
§ cose 29 } 
§ code 24 s 
§ ecode 28 ° 


dete e00539000 1 eee 28 
dafe 060030080 
doth 000300000 


6 cede af 


Gete 000020000 
dete 000193008 
Goth o01000000 
deofe 030030008 
deofe e00330000 


Geofe eocpoeces 8 code 3¢ 
defe COLL: 0008 
Gots Gi0e11000 
defe GiGr 31008 
Goffe O10r0160D 
defe O11egscoe 
Gory GO1310000 
Gots Coccnagse 


dofe e000c060s 2 eode 38 
@ofe GOiraacos 
Goffe 10008008 
dete 000109000 
defo 000199008 
defo 000199008 
defo OLL22200n 
def 00093000» 


defe 000000008 $ code 32 
defe 001110000 
defe Gl00G1008 
000001008 
902110008 
01000000n 
032111000 
000000000 


000900000 i code 33 
001319000 
010001008 
000110000 
090901008 
020091000 
002119005 
000900008 


90002000n 1 code 36 
006919008 
900119005 
001C2000n 
010519008 
042111000 
090029008 
000900008 


000099000 3 code 3S 
0123111008 
010000008 
011230000 
O9000100n 
030901008 
001110008 
O9050900b 


000900008 3 code 16 
003150000 
01099900n 
033219008 
01900691900 
Gefe GL9CEI100n 
dofe 001110008 
deofe 060050000 


Gefp GoocosadD 1 cose 37 


194 


195 


dete GClLa11000 
Gefe 000001000 
dete, 609010000 


Gefe 010201000 
dete 002119000 
defe 603300000 


OOt321008 
000001008 
001139008 
ac6330e0n 


oc9n0000n 
000090008 
eqgc00con 
900100008 
990050008 
gonccoses 
606150000 
900900008 


020360008 
Gocrogccs 
090100008 
ecaccoove 
esseco0te 
60019060» 
900290008 
002500008 


eecoceoan 
036000008 
069010008 
620330008 
002 800008 
000100008 
663010000 
» 02000008 


er6c0108e 
010311000 
019211000 


Gofe 010003000 
dete eaoecoges 


eode 


Geode 


cede 


code 


dof O113129¢0000 
scc0ceeeoe 


o00000n 
cari900e8 
Orcco10oe 
0105690008 
015990000 
9105916008 


@23130000 
O8Cs20008 
O1950100e 
OicrI10On 
6152100008 
O221160808 
e00005000 


Gosoccods 
OILED 10Ge 
010553008 
@11210008 
036050600 
@10000G08 
OL4122000 
O00200Gue 


gootoaads 
OUtrarsds 
O1G500008 
@LL12000n 
OL9590008 
G10500000 
16560000 
6055690008 


o00300CGn 
902110008 
015931008 
@10390008 
15332008 
616501000 
GOL 660d 
CO Co008 


OG5550000 
610291000 
0802510008 
OLad 008 


019901000 
916921005 
019793008 
000500008 


o00e0b0de 
012211008 
oocr00ede 
005300008 
0092200008 
000399000 
O21131000 
0060290000 


000090008 
00000100» 
090001000 
000031008 
010001008 
010094000 
001211000 
000200000 


603000008 
010019000 
Q1690000 
011052008 
0162060000 
G20020000 
610001005 
0900300008 


000590008 
0360590400 
019690008 
610390000 
019790008 
01023C0008 
01211100608 
@oococ00s 


600090008 
019901000 
Osicilces 
020261008 
O10701008 
010051008 
G20001008 
609009000 


00003900 
3803 defe 616003000 


196 


sede 63 


Code o6 


cede 66 


eoee 47 


cede 49 


code 64 


code 4C 


code 36 


197 


@170010%8 
610031008 
et3cs1e08 
eeecseseee 


C2e0c1Gee 
eccco1eee 
e1000100e 


ce30000ee 
0100399000 
@162230008 


Goesceede 


900330008 
026593008 


0109010¢0 
011032060 
O10101060 
o29701000 
014031600 


00053900n 
830001000 


e1rectede 
010291008 
020131000 
0160131030 


. 
eeccl0eee 
eeoosceee 
O6R10600 


810020068 
GOLtLOeen 


code 66 


code 49 


eede 66 


sedq 47 


eede 48 


code OP 


sede 93 


eode 33 


oeeecsoce 
@210308000 
01650100» 
Or6coleds 
01990100n 
010001000 
OO2220000 
eoocoscen 


e00cGeGde 
010091608 
616991008 
010592000 
030991008 
002033000 
000300008 
eoccceece 


9290950600 
016001000 
016091000 
010331000 
O801010008 
OtereLoce 
601010068 
defe S00ccaooD 


coors. 
020991000 
002039000 
@09103008 
003190000 
OO1C10000 
Gefe 810901000 
Gofe 800000008 


Gefe 609090060 
dofe GICCOLoOe 


001030000 
Gete 096369600 
defe 600103008 
Gofe eeorecese 


eoecocede 
OLI151000 


oes000000 
001000000 
001000000 
OO1219008 
069900080 


e00c30e0e 
000000000 
0100900008 
o90ces 
00920000 
oecc sCen 
90c301600 
000600008 


06090000b 
Orasecces 
000200000 
000230000 
906300008 
@00100000 
OrriEdees 
beocesete 


a00cetoee 
009200000 


066600000 
080000000 
O0¢50000n 
eoocco0es 
defe eeccceace 


198 


ity 


$s? 


tld 


1700 oocoocade 

1703 b a00ccd0ds 

1702 111821008 

ares 

1706 o0000000e t code 60 peund sign 
ives 000110008 

itee 0023001008 

3t0? 02112000008 

1708 901000008 

1769 00100000 

1710 OLLL12008 

17313 000000008 

ivaz 

ava3 00000000» § cade 62 a 
avis ngdo00dde 

amas 001110008 

1726 000001008 

3747 001921000 

1718 0200020up 

479 00212100b 

3720 000000008 

172s 

1722 900000008 8 code 62 i) 
av23 001000008 

1726 001000000 

avzs 001220008 

1726 003001008 

4727 001001008 

1728 002210005 

1729 000000908 

1730 

3733 000000008 i cede 63 € 
A732 oo000c00d 

1733 090211008 

1734 o0100000D 

1735 601099000 

1736 601000008 

1737 000113800n 

1738 000000008 

1739 

1760 000000008 § cede 04 a 
1741 000010005 

1742 0005190008 

aves 001210008 

ites 020010000 

av45 610919008 

1746 003310008 

2767 000050000 

ives 

ives 090300300 3 cade $8 e 
i790 800000008 

avss 602310000 

2782 030001000 

a7ss O1221000n 

arse 010900008 

ivss OOR12100e 

irsée 0006000000 

ars? 

1786 000000000 3 code 66 € 
avs 003100008 

aree 602010008 

1768 032100000 

1762 001900008 

1763 901000008 

1766 001900008 

1765 oocoocadn 

1706 

376? 000000008 t code 67 e 
1760 090500008 

1769 901110000 

3770 020010008 

arta 610010000 

av72 003110008 

arrs 020210008 

L776 O02 00008 

477s 

avre 000600000 8 eede 6t * 
arr? 62090000n 

4776 610200008 

a7Te 641200000 

veo 910020000 

4781 019510000 

1762 036010008 

aves 006000008 

ives 

ives o0ca00008 1 code 69 4 
1786 Qdc130008 

17e? O0955000n 

1700 Souresods 

1709 Oo0ats000n 

1790 aoct3000e 

1701 dete OOLAtIoCn 

3792 defe Q0ac00G08 

3793 

L794 008500008 § cede 64 4 
ives 696310008 

21796 005000008 

ave? 000510008 

i796 0055200008 

ives @efe 005510008 

4000 defe 0630519008 

1603 dof 062200008 

t802 

1603 defs caenoodts  coee 66 t 


199 


200 


OORT STOO 
0017520000 
003190005 
003359000 
001030008 
001791008 
e00s5s0008 


000399008 
001390008 
OOICS000n 
00335000b 
901630000 
001093000 
O00tL 000d 
6ecc 30008 


ooostooote 
oocccoeoe 
003519000 
O8O1C1000 
010191000 
Oichs100D 
036191000 
OOCCL 2000 


eccccoode 
600630008 
OLLL9900D 
036023000 
010555000 
6160610008 
920010000 
860600000 


000630008 
06070000n 
003129000 
01095200b 
6100C1008 
610091008 
003219000 
G0005000n 


e60GC000 
000633000 
G1iiccode 
O40515008 
010613008 
Otisecoee 
026080008 
910655000 


eegncoebe 
eeoneotce 
GOs 0G0R 
010010008 
010610000 
GG1210000 
900015000 


1630600 
O0200000n 
Oorescson 
Coreooode 
000003960 


e00¢03008 
O0CC 0008 
G0120500n 
910050000 
OCbroCaee 
ooocs CCR 
O11209000 
005000 


600805000 
00100300n 
CAIt03000 
0010350008 
G01000008 
601030000 
660120008 
000050008 


eoece0cde 
eoocdoccs 
080010000 
620010000 
910010060 
816010000 
001200000 
000823008 


OcooRbCoD 
800930000 
@10062008 
G10001000 
OO101500d 
001010000 


sede 


cote 


ow 


7 


1s 


iT) 


Gapsy 


201 


occr3co00n 
00059000b 


oonccI00e 
00033000b 
ORCC 51006 
010551008 
010231000 
010251008 
06101000 
g00cco00s 


000990008 
000220008 
026201000 
002920008 
000209000 
063220000 
O105u1008 
600650008 


000293960» 
0003330008 
9206127000 
020013000 
010313000 
002212000 
0005390008 
023100008 


OO0FC000R 
000039008 
011211000 
900920008 
00010000 
001699008 
0311211000 
000990000 


00000900 
000212008 
900199000 
011909008 
090159008 
006300008 
00021100b 
600900000 


909050008 
009180700 
000303008 
00020000e 


0001200008 
000100008 
000109008 
060009008 


600000008 
02110000n 
000100000 
000019008 
006109000 
906260005 
O11800000 
g000G0tde 


OGOCG00On 
001910008 
010260008 
000050008 
600600008 
90003000n 
900032008 
000000008 


@01110008 
16000100n 
2002901008 
102001000 
301091000 
100191008 
10003100n 
011210000 


0900590008 
000000000 
00000000n 
ecooocods 
00000000s 
000030005 
000090008 
e00000008 


OOO1LI 000 
OOO21008 
Qoorsl00e 
00023100n 
000030000 
900000000 
90000000 
900000008 


321090000 


sede 


vw 


ve 


ti) 


tT} 


Ld 


Lid 


70 


ve 


w 


CoPvatcnr 


ereshics epece 


erephics 


eraahice 


202 


122030000 
1i1o0ccdoe 
111663006 
000232900D 
80620008 
G00530008 
occeso0Oe 


832202008 
VLLITIOCe 
ALL311600 
22212608 
OCO98200n 
900C 20008 
000209900 
390209008 


800000008 
800072008 
800C30000 
900052008 
OOO111008 
000151000 
90021100b 
800213008 


000231000 
090131008 
O0081200n 
000131000 
000152000 
000211008 
000111008 
GO0233000 


122660008 
4LiCe 3000 
421362000 
11102C608 
000122008 
GOO%s160n 
900321000 
0602332000 


1222331000 
AL2222000 
13822000 
322232000 
920113900 
O00312000 


COOLS3090 
000211008 


890055000 
ococcsocoen 
600053000 
G000CI000 
942033300 
1t16o900b 
311053008 
412009008 


@oolr1OoN 
000221000 
O00833000 
COOTRI00n 
113039008 
321033000 
411030008 
2050000 


ib190300e 
312990060 
UasCoseoe 
disecoode 
122003008 
aipo0o0todes 
1115600008 
ULOSdoVe 


Ub2221008 
422221000 
ALL211000 
ALLAL1OG0 
LLLds000n 
291032000 
122059000 
Ubacoocen 


000562000 
O00C0 2000 
660005008 
000062000 
322321008 
AALLd1050 
2D2822000 
VALaeloOGe 


OOO1R Toon 
COC LALOCe 
OOOLL100n 
060821000 


¢ code 06 


teede 87 


4 eoee 0C 


erashicn 


ereanies 


ereshics 


ereshies 


wehics 


eraphico 


ereohics 


oraghios 


erephices 


eresnhice 


ereonies 


a 
€ 
Cuaser 
Cueseo 
Cuasc2 
CuRsc? 


iJ 
Ounnsey 
enaaery 
eerate 
Gercue 
Gaensy 
GTCure 
GTCmd 
CTcne 
OFinoK 
tnvear 
Lngu 
MARGIN 
MOEKT2 
nose) 
Pacenn 
Scturt 
SCaurt 
serTate 
Setnso 
SaTuSe 
STecKno 
ST0OSN 
TsTea, 
upoate 
URCHAR 
wacmia 
weCny 
WASTES 
wagtyy 


Aaditional 


leservee 

eorved 
oare 
ozre 
Ozat 
o2te 

Reserved 
core 
O1ee 
o018 
0306 
orve 
oo18 
0366 
O3Ce 
0034 
Ole? 
Osje 
0030 
ocea 
ols. 
gang 
arou 
0237 
012 
0919 
9016 
Oza 
0350 
Gare 
ose 
odez 
aces 
eoes 
oles 
ola? 


tn 
Tw 


2114 
2347 
2428 
2119 
2120 
2123 
2122 
2123 
z226 
2323 
2126 
2127 
72328 
a12¢ 
23306 
2331 
2132 
2133 
2136 
213s 
2136 
2337 
2139 


input efter ENG statement ignored 


arrery 
caccea 
Cmast 
CLasce 
Crascs 
Cumsat 
Osten 
ORIVES 
Extunn 
Geraty 
Gercs 
CaPst 
GTCHE 
GvCmys 
GTCSme 
4 

t 

ucor 
masas 
wexts 
MIOSTRE 
onant 
scacre 
S$CRLO 
seraty 
SerHO8 
SETMSK 
STSUKE 
sveccr 
Tsfo. 
UP POs 
waCnae 
wACats 
wacns 
wRSTRQ 
WRSTRI 


Ne errers cetected 


$039 
9s3ac 
os7e 
0098 
O282 
Ozer 
0900 
e800 
Osea? 
03¢6 
osec 
oore 
o33e 
0307 
osTs 
Gecerves 
Reserved 
o205 
0o38 
oxoa 
ore 
ste 
0026 
oles 
O2re 
0023 
0320 
Q200 
oc3e 
oec? 
osor 
Oost 
0006 
0096 
Oira 
03s) 


tr 


In 
tn 
tn 


arrery 
CaLcrL 
Cre. 
Cust 
CuRsce 
CONven 
oesr? 
e 

Le i) 
Gerceo 
Getvay 
GATaL 
GTCmz 
CTCuIZ 
GICZOC 
WAERPT 
LOPCSN 
Locre 
mevest 
nOtnve 
noxon 
PSw 
sceus 
scacun 
serceo 
setaos 
S870 
STeua2 
Suva 
T¥PULQ 
vaes 
WACan? 
WACHe 
waCne 
WRSTay 


6041 
o526 
ooze 
O27C In 
o2zas 
oenc 
PrCO 
Reserved 
*7C0 
9306 
oeac 
oo31 
0363 
ose3 
0360 
oorP 
osse 
o296 
Gte0 
Ona? 
oocr 
Geservee 
Oo2a In 
Oice tN 
oa 
Cory 
oscer 
O266 
006) 
Ose8 
scs6 
o1se 
aces 
O0aP 
eire 


413321008 
341322000 
ARBILI00D 
22212100d 


111000008 
112900008 
411000000 
111900000 
2ALA31000 
4s2221000 
$42311000 
141222000 


112112000 
3212122000 
QAlL111000 
412221000 
AA2128000 
TLLIUEIOGD 
BALL22000 
LALEALCO® 


6 
Carer? 
CLrIntr 
cuRsco 
Cuescs 
CcoRos 
OFsoRs 
Qnevex 
OLaTOL 
Gercry 
s000ee8 
GTCHar 
GTCm22 
GTCus 
Grc2en 
twsoe. 
LIncce 
Loar. 
MSRCTL 
nomat 
neTSe 
#anroe 
scaced 
sc#sz 
sercus 
serno2 


WRSTRZ 


Crese reference listing (HAEP version 4.7) 


Syavol 


array 
arTcts, 
OOTUN 

Caucrl 
cauce2 
Caucra 
CunGuey 
Curser 
Cwrst 

Catar 

CLINIT 
CLRCTL 
CuRseo 
Ciasce 
CURSES 
CEasc2 
CLRSC3 
CLASCe 
cusses 
Cuasce 
CURSCT 
CURSES 
Cuasen 
CUaSKY 
CONVEm 
cqgros 
Cuseos 
Oatae 

OesT? 

Oraces 
orert 


ORMSPT 
Oatves 
Qnecla 
Qnsung 
enenet 
axtTnan 
IK 

wURTee 


Refs (# = definition 


lgee 
ese 
1180 
1942 
1059 
eve 
aze 
390 
39 


orzs 
640 
322 
10e8e 
10620 
1023 
992 
1246 
lizae 
irs 
932 
$55 
$540 
sa? 
$32 


64% 
626 
620 
Gliese 
635e 
ave 
5STe 
63t08 
697 
ais 
a1c 
‘ar 
60 
10ass 
224 
o95 
oT3s 
$s? 
9o8e 
o77e 
317 
Gas 


203 
9078 
0408 
103108 
as? 
o99 
s20 
STle 


sear 


9068 


ases 


1008 
1089 


26% 
7998 


v7 


203 


ite 


3018 
1107 


Reserved 
Os3a 
1900 
0292 
o2c9 
sero 
0036 
0e02 
1000 
cous 
01462 
O32a 
O3e9 
o3048 
0568 
0291 
o007 
0210 
0085 
ooc? 
Peery 
5082 
e1ca 
Oc1a 
o0os 
Qe6a 

Reserves 
Ces 
ors 
0167 
sce? 
oo3F 
oons 
O126 
oxec 


<blank> © read) 


30468 


eraphics 
graphics 
UoTLN 0020 
Cmncyy ogee 
Cuact. «aoc 
cLascs 0283 
CLesce = =69208 
cuaegs Oo36 
over? 0098 
Qneunc 0608 
Gevseg § 03co 
Gercus 2021 In 
Gran 0200 
GTCHOG =—0326 
G7em23 o3se 
GTCHS o3n6 
GTC z82 osrc 
Imseet = 12C@ 
LINcew §=60033 
Reverved 
ooc2 
oor, 
sccy 
RECLEN 1720 
scaccr aoze 
SUTase O2P3 
sercua Glae tw 
StTHQO §=—03%6 Ia 
STaun 0208 
STmDBO = 3H 1 
TSTPaa |= (0888 
vos scrs 
vVImOcE O06 
waCnil aoe: 
wacn2 oosa 
wastage 0000 In 
wastay §=6910€ 


Geraso 
ceTare 
Geraty 
cares 

Gaercad 
cercrs 
Getcus 
catcua 
Gervag 
GasoRge 


cneun 
GRenst 
GROST 
GRTBL 
oTC261 
oTcza2 
orcas 
cTcat 
GTCmz 
GTCn22 
GTCH2y 


Greuao 
6TCmae 
GTC sHe 
GTINOX 
emenPT 
TNSOOL 
THSERT 
taveaa 


LOPasn 
GENCOL 


LIMLEN 


tmau 
oor 
LOOPG 
£6901 
maeGIn 
Mase 
MOVESZ 
msacry. 
WexTi 
WERTZ 
weat3 
NOINVE 
ngaai 
woae? 
noaay 
wOSTRG 
woxoR 
WAXTSC 
pamans 
Oazean 
Paant 
Rantoe 
RECLEN 
sCInty 
SC@CTL 
sceue 
scaus 
$C8.80 
scauct 


sercus 


setcua 
setage 


SEtRD2 
Satmos 
setaoo 
serase 
iatmss 
stoic 
STaueod 
276.0) 
sVoue2 
STaEN0 
stsoe0 
stPasa 
sreccr 
gute 
Testao 
T$To1 
TSTPan 
TaTees 
Tveuas 
Tvewed 
voe 
uPoate 
aeons 
vars 
yvronco 
vende 


e220 
eee 


439 
91s 


os 
71%6 


1098s 
786 


Ts?8 
Pez 


re 
66668 


316 
566 
8228 
aes 


3010 
1032 


1031 
oois 
are 
Ge7s 


“29 
a4is 


3308 
346 


aa2 


sey 
9bte 


102 


ous 
eoes 
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oats 

sen 673 ob2 #6 
seo 

rea 

190 73 

oof ores 900 oeze 
432 435 ay? 368 
oss ase 993 

tess oees 

$75 oa2 aces see 
31032 
10678 

see 

ooze 


3336 ese6 


$T2 101s idee 


Ose6 
gue Gate 
er2 esas 


wacng ” 
wRCmis 162 
WACHILZ 160 


eacwys 1466 ile 
wacae 163 

waCris ae? 

whCnd 10se 

wacns 199 

weeus 20ee¢ 

wang aay 

water 2980 

waCwan at 1690 37? 
whCnan 30 Te 

weary 302 3098 dile 
wesTag Z| 3e6e 

wasras 3sie 306 

wastaz ass ele 

aeires 342s 392 

wasTaa 30 Tee 

mASTAG 3 v76e0 saa 
WASTES 380 dele 


wa Stx2 39¢e 4g2 


APPENDIX C-3 


40 COLUMN MODE 


Names 60 Column Mode Support 


Oescription: 


This component provides support to the application programser for 
using the s0-coluan mode feature of the TS 2068. 40-coluan soace 
is rmplemented by modifying the character width trom 8 to 6 
pixels. The services incluce position control, clear screen and 
scroll screen services and display of characters. For ease of 
use from BASIC, status is returned in the 8C register pair, 
usually zero for successful completion and designated non-zero 
values for otner conditions. The interface from BASIC is by 
means of POKE’ing the input parameters to designated RAM 
locations pracr 10 invoking the service vis the USR function. 
See page 4 of tne code listing for the meanory addresses te be 
useo from BASIC with the support code loaded starting at Chunk 7 
CE000nN757344). 


Atteibute and cther diselay controls such es Inverse are taken 
from the standard TS2066 System Variables (see Usage Section.) 


This component is designed to permit use in normal video mode 
CDispleay File 1 only) ors, an conjunction with ASC004 - Gual 
Screen Mode Support, to permit use of Display File 1 and/or 
Daspley Fale 2. The value of the System Variable VIOMOD is used 
to getermine which aisplay file is the tarcet of the requested 
service. 


Acolisasioo Secxices 


Name: INIT4O CINITS6S from BASIC) 
Input: None 
Oeseription: 


Initializes the internal variables to their default values for 
40-column mode (see Usage Section). 


i a a a or 
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Newe: CURSCNH CCLESCO from BASIC - parameters to CLSCTL) 


Tmevt? Line Count €1-26) 
Startsng Line Nuaber (0-23) 


free Machine Code: Line Count In Register B 
Starting Line In Register ¢ 


Frome BASICS Starting Liane Musber in CLSCTL 
Line Count in CLSCTL © 1 


Descristion: 


Clears te backoreund coler (PAPER) the designated nunber ef 
lines, beginning with the Starting Line Nusber. Line 0 sith a 
count of 24 cleers the entire screen. Upon return, the curser 
sesitien is et the beginning ef the first line cleared. 


Outeuts BC © 0 for successful coapletiaen 
6C = 1 invalid pareneteors 
(Line Muaber © Line Count <1 or >26) 


Name? SETCUR CSETCUS from BASIC ~ parameters to LINCOL) 


Tnout: Line Nueber (0-23) 
Coluan Number (0-39) er (0-41) 


®ree Machine Ceaez Line Muaber In Register 8 
Coluen Number In Register C 


From BASIC: Colvan Nueber In LINCOL 
Line Number In LINCOL * 1 


Oeseristion: 


Converts the requested pesition te internel format, deternines 
display file addresses, and steres the values for use by the nent 
disclay character ation. Note thet once estanlished, the 
sesitien ts updat autoestically shen eo character is displeyes 
so thet it is only necessary te set the position ehen sequential 
dasplay is net desired. 


Guteut: BC = 0 for successful completion 
8C = 1 for invelid perametors (Line Nuader > 23 5 
Celuan Mueper > Line Length=-1) 


Name: WRCONR CURCKE frome BASIC - paerometer to DETAR) 


Input: Character code for character to be disclayed 


20% TO TEM = See. TS2068 Character Set 
Q0m TC SFu = Ste. Graphics Set 
90n TC BON © User-Defined Graphics Set 


Brom Machine Code: Register A 


Feoe BASIC: in DATAB 


Description: 


Oivelays character et current cursor position, apelying current 
attributes eno mask. Moves cursor position on to next seavential 
position. If character would start 8 new line after BOTLN (see 
Usage section) sn¢ the scroll count Cwariable SCRLCT) decrements 
to zero, the character will not be disrlayec and return will be 
made with 6C = 3 (sereen full). If the scroll count does not 
Geocrement to zeros the screen #311] be scrolled up one line wsing 
the infermetion in SCRCTL and the new line started et the vacated 
lane. 


Note that only the first 6 bits ef each byte in the User Defined 
Gracnics srea will be transferred to the display file. 


Ovteut? BC = 0 for successful comrletion 
6C = 1 invalie character code 
BC = 3 for screen full 


ee ee we ew we ew we ew ee ee ee le hl tl tw 
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Wome? WRSTRG CWRSTRE from BASIC = String Identifier in PARAKS) 


Input: Character Code String 


Freee eachine cede: Adéress ef string in HL 
Ceunt in BC 


From BASIC: String Variable Identifier in 
System Variable PARAMS = 237467 (S5CC3H) 


Deserartion: 


Oiscleys the charscters free the string, beginning et the current 
curser lecetion end continuing sequentially until the count 
@xpiresy er “Screen Full” 18 Getected Csee WRCWR description and 
Usage Section on Automatic Scrolling). For the Screen Full 
condition, the ressining count is stored in the internal variable 
STRGCY fer access by the user. 


WOTES Characters within the string which are eutsi¢e ef the 
Supperted range (32 threugh 164 CZ20K-A6H) ) will de 
fgnered. E.ges BASIC Token cedes and control cades 
eabedded in on INPUT string will not be displayed or 
decoded. 


Freep BASIC, POKE the coge for the string variable identifier into 
OaGans prior to invoking WRSTRB, e.g. 


0005S LET sh atmommestringenen--% 

0020 POKE 23747,CECE “8% 

0025 FF USR CWRSTRBD<>0 THEN o---- 
Ccontinue) 


Sutorct: eC #@ 0 Successful 
8C = 2 BASIC - String mot found 
9C = 3) Screen Full - Remaining Count in STRGCT 
CoLeCurrent Address in String) 


Name: SCRCLL CSCALB from BASIC = carameters to SCRCTL) 


Input: Line Count (1-23) 
Starting Line Number (1-23) 


Beee Machine Code: iine Count in 8 
Sterting Line In C 
From BASICS Starting Line In SCRCTL 
Line Count In SCROLL © | 


Jeseriction: 

Screlis the designsted number of lines up 1 position, starting at 
the specified line number ane inserts 8 blank line st the bettes 
ef the serolled sree. Line 1 wath a count of 23 sill serell the 
entire screen up i tinee Unen returns the curser pesitien is at 
the beginning of the inserted blank Line. 

Note: See Usage Section on “automstic” scrolling. 

Qutewt: BC © O Successful 


ac = 1 Iavelld Parameters 
{Line Number * Line Count ¢ 1 er > 24) 


er eme ere ew eee eee er een ene ewaecw ene ew ee ew oe 
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Namet GICMAR CETCHRE free BASIC - parameters to GETCTL)> 


Tnput? LanesColuan psasition as for SETCUR 


Feoe Machine CedeS Line Number in 8 
Coluan Nuebder in ¢ 


Sree BASIC: Celumn Number in GETCTL 
Line Number in GETCTL « 1 


Description: 


Returns in register C ef the BC ragister pair the cnaracter cede 
for the cnaracter et the designated screen position. If ne astch 
ageinst the ecnaracter set Cincluding the standard ane 
user-defined graehics) is founds zere is returned. (Cheracter 
code er sere aise returned in A.) 


Netet Pesitiens “printed” using the OVER technique will return 
zero if they Go net Batch against any single cheracter. 


Suteuts rY4 ® 8 ter ne fing 
OC = 1 invalid parameters 
SC = character cede (20H-AbN) 


coerce werecerer eer eee eee enewreeo eee enenenwzwneowe we 


Nome? GETATT (CGETATB frer BASIC ~ parameters to GETCTL) 
Input: a8 for GTCHaAR 


Description: 


Returns in register C ef the BC register pair the attribute byte 
fer the character at the designated screen position. Note thet 
in 460 coluen mode the é-pinel character sidth apy cross attribute 
byte seundaries in the display file (e.9. the character may have 
2 pinels in one byte and 6 in the mext). The attrioute bytes for 
these two lecations may be ¢ifferent. The value of the sttribute 
byte contrelling the starting location of the character «will be 
returned. 


Output: 8C = 1 for invalid parameterea 
OC & attribute byte: 


Bat To - FLASH 
Bat 6 = BRIGHT 
Sit 5 

Bit 6 = PAPER 
Bit 37 

bit 2 

Bit 1 = Ink 
eit 07 


Mare: GETCUR CGETCUS free BASIC) 
Input: Wone 


Description: 


Returns in the OC register eair end in the BASIC parsmeter 
location LINCEL, the current print oosition Camere the next 
character would be discleayed). 


Ovteut: 8 © Line number (0-23) 
€ @ Column number (0-39) of (0-41) 


OASIC: LINCOL = Coluen nuaber 
LIMCOL *¢ 310 + Line number 


WOTES If the bast cherecter was printed 2% Col.39 (41) of Line 
23 (1 esition en the sereend, then Col.O/Line 23 
@ill be returned. 
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Wsaces 


Memory Usage: 


This package of machine code 
internal variables: 


Name Size 
SCRCTe 2 
SCTLN 1 
SCRLCT 1 
CwTar 2 
GRTeL 2 
LINEN i 
Cureas ‘2 
OFACOR 2 
MASKS 1 
array? 1 
GTINOX 1 
STRGCT 2 
MARGIN 1 
OFsiT ‘4 
ATTMSK i 


routines includes the following 


Oescription 


Scroll Control 
LSB = Starting line number 
MS8 = Number of lines to be scrolled 


Bottowr Line - Line number (0-23) after which 
test for seroll wall be made. 


Seroll Count- Number of times + 1 that 
automatic scroll will be done. 
when decremented to zero, data 
will not be displayed and a 
condition code will be returned 
to user. 

Character Table (Base Addres#-100H) 

Std.Graphics Character Table (Base-100H) 

Line Length - (460 or 42 when in 40-Col.Mode) 

Current Position CInternal Format) 

LSB = Coluan Position 

MSS = Line Pesition 

Current Cisplay File Address 


Working Syte - CP FLAG Shifted Right 1) 


Cbit O = GVER ) 
Coit 2 = INVERSE) 
Coit © @ INK Complement of PAPER 
Coit 6 = PAPER Complement of INK 


Working 3yte - (Copy of ATTR P) 

"Get Index - Used by GTCHAR 

String Count - Contains remainina byte count 
when EC=3 (Screen Full) is 


raturned from the d@rite String 
service WRSTRG (C#AS5TRB). 


Margin - Margin Adjust (0/1) 
Oisclay File Bit - Current Bit Position 


dorking Byte - (Copy of MASK P) 
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Initial values set via INIT40O CINITCE) are as follows: 


Variable Name Value 


SCRCTL 1701h 
BOTLN 17H 
SCRLCT i 
CeTBL CInternal to Module) 
GRTBL CInternal to Module) 
LINLEN 28H 
CURPOS 18294 
OF ADDR 000K 
GTINOX 80H 
STRGCT Ow 
MARGIN iw 
oFSIT 7 


The following are the variables used for passing parameters in 
BASIC and their values as initialized by INIT&B: 


Variable Name Size Value 
oaTaB 1 On 
LINCOL 2 on 
CURCTL 2 1800H 
GETCTL é Ow 


In addition, VIOMOD, PARAMS and other system variables must be 
available to these routines. At minimus, chunks 0-3 end chunk 7 
@ust be enabled in the Home Bank. 


Location: 


This package can be incorporated into 8 machine code pregram 
within the «memory range from chunk 6 through 7, taking into 
consideration the remarcping of certain structures shen the second 
Oiscloy file is. open (Dual Screen Mode only). NOTE: Machine 
code above RAMTOP is net moved. 


Registers: 


Other than as documented for output values, no claims are made as to 
preservation of any register contents except for the IY RegIster which 
must always contain the value 5C3AH for access to the standard system 
varfables. 


Automatic Scrolling: 


As initialized, test fer scrolling will be mage when tre print 
position goes to the next line following the bottom line on 
screen (BOTLNeZ3=26tm lined. Condition Code 3 (Screen Full) will 
be returned since SCRLCT will cecrement to rero. If SCRLCT is 
set to sone larger values then the parameters in SCRCTL will be 
wsed to automatically scroll the designated number of lines 
beginning at the specified line number. As anitializeds this 
will seroll the entire sereen up. By pertorming @ PCKE or 
setting the variables @CTLN ano SCRCTL to the aesirec values, 
automatic serellang can be done using smaller sections of the 
screen. When working from BASIC it is recommended that BOTLN be 
set to Line 22 CISM) and SCRCTL«1 be set to 21 (15H) to avoid 
conflict with the Edit Line which uses the bottom two lines of 
the screen. Note that once SCRLCT expires, it will be set to 1. 
If 2 different value 18 desired, 1% must be reinitialized by the 
user after receiving the “Screen Full’ condition. 


By setting the SCRCTL variable and anvoking the SCROLL CSCRLBD 
Foutine any portion of the screen may te scrolled at any time. 
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Margin Control: 


in 40-Column Mode, there are actually 42 character positions per 
line. The variable MARGIN determines the offset of the beginning 
of the 49 column line from the left side of the screen ano has 
valic offset values of 0 of 1. An offset value of 1 centers the 
40 column lire on the screens 6 begins at the extreme left side. 
The oefault value as 1. When MARGIN is set to 0, the variable 
LINLEN can be set to 462 to permit access to the 2 extra print 
positions. Whenever MARGIN and/or LINLEN are modified, a “Set 
Cursor’ eperation should be done to insure the integrity of the 
orint vosition. 


NOTES Since the different MARGIN values result in different pixel 
Positions fer the columns, care must be taken in mixing 
lane length and margin values on the same line. 


attribute Control: 


Attribute and masking Cinverse/Cver) control information will be 
taken trom the system variables ATYR F, MASK P ana F FLEG as 
defined below. These variables contair the “permanent” attribute 
controls set via the BASIC commands PAPER, INK, ERIGHT, FLASH, 
INVERSE, and CVE®, or by darectly eriting to tne specified 
locations. 


In 60-Column Mode, the 6-pinel charecter width results in 
characters crossing attribute byte boundaries in the display 
file. Every four columns across a line are controlled by, three 
attribute bytes. This constraint wust be taken into 
consideration when mixing attributes within a line. Inverse and 
Over are applied to individual cheracters and are therefore not 
subject to the above limitation. 


NAME AODRESS CONTENTS 


ATTR P 23693 Bit 7 + FLASH 
6 ~ BRIGHT 
5 
4 = PAPER 
3s 
2 
1 - INK 
o7 


wasx P 23694 SAME FORMAT AS ATTR P, 
USEG FOR “TRANSPARENT? 
O1sPLay: 
For each bit that is set 
to ls the corresponding 
information will be taken 
trom the current screen 
position instead of froe 
aTTae, 
It 
® FLAG 23697 7 PAPERSCOMPLEMENT DF INK 
S INKSCOMPLEMENT OF PAPER 
3 - INVERSE 
1 + OVER (New Characters 
XGR°o with Old? 


AGCITIONAL NCTES: 


1. €1l screen operations done by the syster ROM CPRINTs, LIST 
Edit lime [70,etc.) mork with the standard 8-pixel side 
characters. 
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aes 
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1 THTERe GCHAR, GETATH, GETCUS 
8 
“ BePEay Warvec,surres 
Te 
set 
37 8CRSz ae ¢ 26 Utnes 
ae $Cint? 27@.10 U SCMCLA COnmTad, THT Pacrrariow 
a0 Cutnr? 10G0m = CLeam SCREEN CTL. Tart, 
oe Cmaset CCCmASTIOLOON) ECAR TABLED OOM 
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& i] 
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os wars tov sCeen # SYSTEM VARIABLES 
“6 uos gc ven ‘ 
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oe o fceon a 
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C3 o2er° 16 Cuescer a CLASSO § ENTRY TO CLEAR SCREEN s73S6 
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eezee 66: 1000 ScM@ucr cere 1 B SCMCLL COUNT = 3 PLUS NO. 57300 
103 1 OF TIMES aUTCMATIC SCMCUL 
302 t WILe BE OONE. 
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eose° 60 109 =maSaO cera q 1 MASA TO BE aPmLreo TO $7400 
aud t 1 OLSPLAY CoAMACTERS 
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WHEN "SCAEEN PULL? s?a03 
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Ca enga” 4 @8futn Bee 


@2ee" Ce eere’ coors 8 Get atvatoure cr 
ezec’ Cs Ouln ac 6 ORICtmaL OC 
oe Oe 8Casz 6 Conveat Te guveeuay PoRmay 
sue 6 ¢ 
8 6.4 
C0 dea Ruan. 
fee «4 t Sev Te Ceu.@ 
0 Oat soneess 
4 Save vestrzon 
: 2 0 
‘ Cuasce postrson 
‘ © OF Ulmks THES Ococa 
0 Conpant Te Tora, Utne Count 
£0. OF Lines 
9 Rematntas clnas 
eveses 
t 6Cin Count 
Cuasce 


Save Glue Cut.cecan Car, 


3 BCa3z20NO. GF LINES 
3 CoO IF 236 POR & LINES) 
# aQsusT 


CERSCS PUSH me 


216 


er 


Qeeo? 
or 


os 
oe 
o2ro° 


46 60190° 


0636° 
oo3e* 


Gear’ 
oasT? 

38 0028° 
60 

oo 

O03a° 


313° 
a9 


as 
a 


CURSKT 
Caeser? 


1 
i] 
GTCmeO! 


i] 
eTCmant 


GTCod 
GTCmz 


GTCm2z 


GTCm23 


GTCHY 
GhCHss 


WIeCLRSCS 
wh 


4 
Catcary 
ast 

7 


Cea 
8,0 
c 


On 

Got 
aeCarvrert) 
Cauda 

oe 


bel 

6c 

a8 

a 
TeCURSNT 


ec 
veceosn 
Cea 

aot 

c 

6,4 

ec 

acc 
cusscs 


Suart. “GET” NOUTINEGS 


to 


Cau 
Lo 
ouse 
Cau 
CaLe 
to 
to 
Lo 
Lo 
INC 
Push 
Puse 
use 
Cea 


40 
and 


3 MERE PAGM BASIC ExTeY TO Get CuaeacTeR 
8 CRETUANS CCOE 04 Craeacrer ar 
$  POSETEON SPECIFIED In GETCTLD 
OCeCGRTCTLD 1 Get CONTRCL INFO. 
t GNTRY ETM POSITION Im BC 
TSYeae t TEST PaAmaneTeas 
AeCbeait) 3 SAVE CURRENT BIT POSITION 
a 
Comvern 1 CONVERT fo INTERNAL FORMAT 
Carcras 1 GET OF ACORESS AWD OIF POS. 
oe, ccmran) 1 Coan. Tage 
e.%e OND. JP PRINTABLE CwAmaCTEeRs 
aeecn t SOT AOJUSTMENT EWOeX 
CGTIMORD a 
° f AOJUST TI START 3F YagLe 
ac $ Save Count 
mL 1 Save ADRS. IN CP 
oe a SAVE A005, IN CHAR, TAAL! 
GTcze¢ 1 GET SCAN CINE PROM OF 19 @86.8 
BGITS Tod 
a8 
OFC hm '6@ errs roa 
6,a 3 OF CHARLSCAN ROW IN 6 
OBsme t CHARLSOT PTR. TO ML 
Erode 2) 1 PINBL ROw PROM Cran. Set 
orce fo mase To © BITS 
® 3 TEST AGAINS OF ImaGE 
TeGTCmy 4 Maycu 
ap 
eCOTENSH) a TEST IF LOCKING Af STOLGRAPMICS 
90" 
N2eGTCNZY 
an 
Sree 41 OO NOT TEST INVERSE TP GTOLGk, 
OPCm boTes?’ If Inverse 
NL eGTCme 1 OORS NOY MATCH 
Coa 4 Cad POR MATCH =6 POR tNvEeRSsE 
$e? t SCAN COUNT 
Of om 8 OF AORS.TO HL 
ec 1 SAVE MATCH AND SCAN COUNT 
" U Next SCAN Im OF 
oe TNONT ROw IN Coaa.set 
GTCRBC CO NGNT SCAN OW TO OC 
4,0 
OPCH 
O,4 
Olam 1 CmaRSOT PYM, TO me 
beCme? SPINEL ROw TO 4 
Oren 
6 TEST matca 
ac 1 GET PREY.MATCM OND SCAM COUNT 
¢ 
WI6GTCHS 1 WO MATCm=~START aGatn Of wEeKY 
GTCm31 100 Nex? $CaN 
ac ( hens If MATCH ON INVSaSE 
aed ’ TP MATCH Cu SmvEaSE 
bc i ATCw~ CSP >aPTEL TO Cae, 
ee SIM TABLEICSPe2>.aCwas. IN CM: 
ac t CSPeereCHAR COUNT 
Coa VP OeCOUNT Cond If matce cy SwvERseE 
SOC6TiNaK? 1 CONVERT mater TO CHse.cgcs 
20" t TEST 17 matCn ON SPace 
MZ ,CTCH32 tomo 
c + TEST 2° maTCm ON Invease 
ME OGTCHS2 


nt we we ne we on oe oe 


CLEAN OF 


Mex? sCaw ROW 

OOP LINE/SSCAN CCUNT 

DECR. Stam COUNT 

WEXT SCAN 

SAVE NEXT DP ates. 

Cast scan CF Curae, 

GET AGRS. IN AFYRIBUTE PILE 
wO. GF LINES THIS BLOCK 


8Ceoszeno. OF LINES 


aosusT 


ATTAIQUTE VALUE 
UPOATE ATTRIGUTE FILE 


OF AORS.CLAST SCANO1 90%) 
TOTAL UImée COUNT 


ME aSTART OF NEXT BLOCK 
BaREMATNING LINE COUNT 
CURSOR POSITION 


RETURN VIS UPDATE an STCRE POSITEGN 


SAVE NO. LENES THIS BLCCK 
40JUST TOTAL LINE COUNT 


REMAINING LINE COUNT 
RIMS TwIsS SLOCK 


$e Sc76 


o8 e619" 


41 6067" 


red 
790 


183 
744 
rss 


163 
Tee 
765 
Tee 
67 
48 
719 
770 
mH 
142 
773 
774 
715 
77% 
717 
779 
779 
7ao 
mai 
raz 
ra3 
T4064 
ms 
7a 
mar 
vee 
7e9 
790 


om en an oe a oe 


£Oa0 CODE FOR CaaPuIcs Srace 
@etuin Iw REC. C OF 8S ware 
an In REG. & 


@estoee OFgzT 
Cuae.caoce TO A 


OTR. TS Cum, SET 
CVE CN TO MERT Craeacter 


or a0ceess 
Cmuaa. Count 
OECeemenr Cmse.COUNT and Gan agate 


Test 16 OGNe 

TEST 18 STC.CmR. Set 
TRY Gearatcs 
Gaapmics Tage 

MO. OF EWTareEs 


TEST If $TO.GRAONICS 


TRY USER-DEPINED GRAPmICS 
ADJUST a0088SS~1000 

WO. OF @nTRIES 

INOEx B09U87 


mG mavcw OF fut 
@estoes ORIc. OFEIT 


aces 
ae 


Get avveteure evre 


WERE OOM BASIC ENTar 


EOE WITH LINESCOL. Im OC 


Test PaRanerens 
Savi CURRENT BIT POSITION 


Conver? To Infeanal PoORMAT 
CaaCucarel OF OSSITION 
CaLCucaTe ATTAIOUTE POSTTION 
arrereut’é Byte To 6 

OSS Baca ta OC 


@ESTCHE COPBIT) 


ATTRIGUTE A430 En a 


Get CuRsoe POST TLON 
MERE PROM BASIC EnTaAy 


Get wwreewac PCSITICN 
Conveey VO uses wcamat 
Test 29 eno CP Utne 

Th 060 CA 42 


ag 
MEXT POSH.START OF MEST LINE 
Gume T* wet tne 
ves” £6 OPP SCRken 
“NO 
POSm. £3 av GOTTan Lint 


STORE PON BASIC OROGAAR 
VALUES 4496 In OC 


SUGTTL IMITIALIZE 40-COL.MODR 


to a,0ha 
G¥Cw32 bo Cos 
to 8.0 
eoe ae 
to COPRITI A 
to aol 
ner 
8 
Grcns or wm 
uo ote 
40d mL OE 
‘0 Oot 
.o Don 
Ly) ee 
oom §=8t 
Osuz GICH2 
f] 
40 &eCGT3NDx) 
ce Gon 
aa ME GTCHS 
uo oCsaran) 
io 
uo 
Ja 
Grtns ce oon 
at ME eGtTCme 
to 0&,CuaG) 
eec 8 
4o Oo2t 
40 &,tagn 
we orcns 
8 
STCne eae ae 
Lo < 
to Ce8 
noe a 
aet 
i 
s 
5 t 
GeTases 40 OC .CERTCTLD 
i iy 
Gavatrs 
Cale stean ‘ 
to &.COPOTT) 1 
Putin a6 
Cals Conven ' 
Cate Canceos ' 
Cana Caucaty i] 
Lo aeCm? i 
to Cea ’ 
4o 6.0 
oor ap 1 
to COPRTT ea § 
to ae ' 
eer 
6 
‘ 
' t 
Gerces: ' 
Gercurs 
oo OCeCCveros) 
CALL CONVeN 
£0 Ae CR TMLEND 
ce 
dh ME GRTCE 
40 Cot 
60 Ast 
inc of 
to oa 
co aa 
oh CeGeTC! 
400 00523 
Gercs 40 CLENCOLD BC 
aet 
(] 
t 
: 
i] 
IntTeos 
10 MLSSCINIT 
C0 CSCACTL ome 
LO A.23 
LO Ceotnw),« 
L0 fel 
LO CSCOLCTI A 
LO 8560 
LO CLINLEN) ea 
LO 4&1 
LBD CMARGIND GA 
LO MheCRINIT 
LO CCURCTU Do ML 
xOR A 
to CSTAGCCT) A 
to CSTa@cCTo1).a 
to AL Cmaser 
Lo CCOPSL) ome 
to ML Gans? 
to CGRTBL) smi 
' 
$ 
to COMTAS) oA 
to CLIMCCLDOA 
Lo CLIMCOLO1),& 
Lo CG8TCTL A 
Lo CGETCTLOI eA 
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Wee we we we me we oe 08 we oe oe 


et we ne ote oe we 


INITIALIZE VARIAGLES 
SCROLL CONTROL 


@OTTOM LINE 

SCROLL COUNT 

LINE LENGTN 

MARGIN 

CLEAR SCREEN CONTROL 
STRING COUNT 

STO, 40-COL.CHAR.SET 
STO. SO-COL GRAPHICS SET 
EMITIALIZE BASIC INPUTS 
Oata avTe 

COLUMN 

LINE 


"GET" COLUMN 
“GET? LIme 


asos? 
enn’ 
@419° 
oans* 
0616° 
Oa19° 
aetar 
oe1ce 
one’ 
geune 
ee2i° 
Oa22° 
gazs° 
0420° 
0e27° 
oa29° 
oa2za° 
028° 
oazc’ 
420° 
gezee 
azar 
oese* 


oass’ 
oo93° 
oe3s° 


0407" 
Oeea* 
Ose’ 
oeac’ 
0600" 
Geer” 
o-90° 
cosa? 


@as2° 


0652" 
ass? 


3a 
a 
6 
s? 
ri 
te 
Lia 
ae 
oa 
tid 
os 
co 
iid 
oa 
ae 
a3 
ae 
23 
+ 
a3 
a] 
6. 
ce 


oe 
06 
ce 


3e 
ee 
36 
"1 
€3 
ya 
36 
os 
3a 
ce 


co 
aa 


0000 
sc76 
0033° 


16 
9052° 
Qa3za° 


02 
00 


a? 
ae 


onae° 
033° 


*s 


oo33° 


oasT’ 
a2 


O47E° 
0033° 


ae 
as 


oo30° 


90 
or 


63 
02 


oo38° 


GETSTARG 


GTsTaa 


GTSTR2 


i] 
NOSTRG 


vsteaa 


PSTPay 


1 
‘ 
COnven 


7. we ot os at ae on 


aucecs 


Caucoz 


\o 
Lo 
to 
tac 
to 
10 
cate 
rid 


MLO 
CCCORLS) mL 
AS CUINLEND 
A 

Coa 
BeSC#S2 
uUPDPosn 
Gsocest 


SUSTTL INTERNAL SUB-RTNS. 


Lo 
ano 


Lo 
ce 
ae 
eae 
1 
iw) 
pec 
ce 
ae 
aer 


to 
tHe 
sue 
to 
to 
sus 
to 
eer 


OOPOSNE 


CALL 
dn 


PLOT POSITION 
MORE POSITION TO BC 
s LIMe O/CCL.8 


CALCULATE AND STORE MGME POSITION 
RETURN ECHO 


AoC Pagans) § GET S7RENS 10 
196 0 MASK OFF UPPER BITS 
oon § STRING VARTAGLE TOENTIFTER 
Opa ? $ave IW oO 
mL Cvans) $ FINO STRING 
Bo Cmu) 4 
O7Pm 1 TEST LP ENG OF VARS AREA 
LewCSTAG tO NO FIND = RETURN BCe2 
a 1 TEST IF matca 
LeGtsraz § FOUND STRING 
oe 1 Save STRING 10 
@ecuen 1 RETURNS ADRS. OF NEXT VAR. IN OF 
Otome t aOR. TO me 
oe 1 RESTORE STRING 0 
GTrsray 1 LOS« aGatIn 
aL 1 GET LanGtn 
CoCmud 
LS 
BeCMe) 
mL t PIAST Text ccoeE 
aed 2 TRSt IF MULL STRING 
c 
O ROTUAN CER IF MULL STRENGSNZ Te NOT) 
Cel 
$,0 
§ C2 ANG OCa2 FOR NO FENG) 
( TOST PARAMETER VALTOITyY 
t BP MOT VAL, OFSCAROS RETURN 
1 AND EXITS Vid INvPAR 
ae23 4 TEST GENE 923 
6 
AC, TSTPR) 
an 
INvPaR 
Ae CLINLEN)D 
ri 
¢ 4 TEST COL. DLENG LENGTH=1 
C,Panean 
' YT LINOsCOL. PROM USER TG 
1 AL FORMAT ONO VICE veRSa 
1 USER FORMATS LINES O23 
4 Chie O-39C01) 
Vo InTeamsy PORmaty 
t LINES 26-1 
' COLe €832464-2 
iy CCOL.LS ENC DF LINED 
Me CLINLEN) 
ry 
id 
Cea t CaonvearT 
Ae SCREE 
8 
O,a 
1 ENTER MERE UITH BCOLINESCSLAOIN 
1 INTEGNAL FORMAT 
Carcros 2 CacCucatveé SCsirign 
STPCSN § STORE UPCATED PISITION avd RETURN 
@ MOUTINE TO CALCULATE POSTTICN IN DF 
$ VPOSTES BIT POSITION Im VACIAGLE OFRIT 
$ METURNS SA ADORESS IN MLe = ORESERVES 
1 LIMECCOLOPCSITICH In OC 
Lagu 3 GOT OLSPuAy PILE ADRS POR LINE 
Ao CRINLEND 
a 
¢ 3d GET COL. WG. 
ae t SAVE COL, ME COMCLIWLEM-1>) 
e,a 
hea 
art 2 3 OC4O-COLAPOS> £6 @ S2-COLLPCS 
a 
a 
€,a 1 
By CMARGTAD 1 GET ADJUSTHENT VALUE 
4.8 
Gea 
be6 1 OF COnTatms COPSET INTO LINE 
mi .de i omy CONTAIAS OF ADCRESS 
t.? 
ap 1 BOCEL.POSN.FPOR 00 COLS. 
3 i 
2eCacce2 a Svaeys af O17 7 
€ea t STARTS aY O17 2,3 Ga 8 
ry 
at 
COPOITI SA 


eoree ce 


ar @ OCepas. Meccr agpeess 
‘ 
aedus 4 GET OfseLay FsLe aoceEss 
¢ Poa sree? CP Utne tn 6 
C0 4,8cesz 
sus 6 
0 Oe 
aace 
aaca 
anca 
ano eeen 
te bes 
8 400 
aud 36m 
oa = 4tn 
(Sey 
sce2 ‘Te rati by 4 Vest sh ustne OFS 
ty) Ost 0.4 
aey sot 
6 As 20m ¢ Usius OF2 
a) 
(oe! 
er 
Srpesus $ BVoRs CuesoR POSTTION 
60 43 G036° &8 Couns), OC 
a2 06036° C0 CoPadasr ome 
ce aer 
i 
coPosas @ LOae CuRsoe POSITION 
QO 08 000° 60 6C.¢CCuneos) 
aa cose’ LO mL eCbPanRs) 
ce oer 
‘ 
eeas? urcarts § UOTE ATTaZGUTE BIT! POR Cmakectae 
t a Just Satnteo 
' 0 ML @ ANY 8CON OF CHah,ty OF 
(] 8 
’ 6 3F CraPACTeR IPans avtareure sere 
8 € GGUNOART, BOTH artersuve OrTEs wtar 
4 1 @@ aOsUsTeO 
' 
Cake Caccart # 0008. OF attateure Byte to ms 
66 4.corerT) ( Save OLT wCstTION 
Outm ar ] 
£0 8 aecerrerr) 2 Cusaen? arterpure GYTe verve 
to fea ater 
to MeCattasa) § masa 76 5 
66 O08 
to Oe CPASKG) 4 Lacs 
(ee 7 373 6 
ueoare 10 8 &.cmed 3 GYTE PROM ATTRIBUTE PILE 


8 Maw ATTR.PCR @3 CLO FON 1 
4 SOY Imm COMPLEMENT CF PAPER? 
' 
8 SET tmx TO OLace 
OI? % t 1S paren a-7 
Pil Wl ,uroaT. 3 VES = USE BLACK Inc 
oe 6? m0 = USE watTe Can 
' weoavs O2f 65F = SET PAPER COMPLEMENT GF tuK? 
J@ = touPoat2 ’ 
an @C7H 1 Sat Papee TO SLacK 
Ort 258 82S Iwan 4-7 
aa WE ,uPOaT2 1 8S + USE BLACK PapED 
oa 3am § NO = USE UNITE PAPER 
wroatz LO CHL Ded a TO ATTRIBUTE FILE 
eS prsereens 3 VEST BFY POSITION 
Ja mC ouPOATE 3 CoaMetN SINGLE GYTE SP STARTS 
’ 1 In Oty 7 on 8 
tac mt 3 CHARLSPANS 2 OYTES Lf Staats 
0 fe? ’ 
to COPRIT),A $ Vameqeaatiy sev fo 7 
sa vroate 2 UPOATE WELT BYTE 
8 COPETTCT wELL PORCE EXIT ano 
§ GRIGINAL VALUE OF OFOTT WIL 
8 68 REsTOREO) 
‘ 
weoaTs fae af ¢ GUIGINaL OFetT 
oo3e° to COPEITICA 3 Restore 


i] $ SUB-RTN. TO CALCULATE ADRS. OF 
] 2 ATYAIGUTE BYTE PROM aces. OP 
i] 3 amv SCan ROW In OF 
8 
‘ § USEO SY UPOATY AND GETAaTT 
4 
caucart ¢ uppae Br¥e OF aoDagss 
ca = 86" 8 a08S. GF atTeseurE BYTE 
ert Som t TEST wnsce oF 
st be Sauces 1 OFL 
ca 20a 6 aF2 
COLCA 48 eA 6 08S. OF avvereurs 
aay 
3 
Loarres LOAG INTEAhaL ATTRISUTE vaRreeLes 


$ 

t PROM SVSTAM VARTASLES 
8 
$ Save a 
‘ 
Y 
t 
t 


4 SmZPT O00 O2Ts Ta even 


OS08" 32 GOxE’ 1023 Lo CMASKBD SA ' 


OSa3° #1 1dd6 for af 
ostz° ce 1028 eer 
1026 1 
1027 ’ 8 RTM, USED BY GTCHAR TO PUT 
1028 i $ @ PENELS FROM OF IN B REGLBITS Po2 
1029 f] $ POR MATCHING AGAINST Coad. Ser 
1030 1 
Osis’ fs 1031 GTC2Z6C PUSH om t Save OF aORS. 
OS14° 46 1032 Lo Bech) ' SCAN LINE #R29m OF 
esis’ 23 4033 tac LS t NOE? arte 
O916" 46 1034 = «=6GTC283 «40 CoCmu? $ OC CONTAINS Cram. ar OFOIT 
OS17° 3a OOSE? 1038 Lo aeCOPOrt) 
0514° 68 907 1036 sue ? 
GS1C° €C és 1037 WEG 3 AeNQ.OF SITS OPRSET In OC 
osie° 28 QF 1030 Ja T,eTC2e2 £ Staats av art ? 
OS20° Ce iL 1034 GTCSmPY ay ¢ 
OS22° Ce 10 1000 me 6 1 SHIPT 6 PLKBLS POR CHaRacTER 
G$2e° 30 1041 oec a 6 TO Be O3TS TH? 
O325° 29 #9 1002 Ja MEeGTCSMPT 
Osa” G4 2043 Gtcaez PoP LIS 1 
osze”" Ce 1006 aer 3 CHARLEN 8, BITS 72 
1005 i] 
1006 
1067 INCLUDE Cusyad 
1068 SUBTTL CHAR.SET POR 407800 COLr.MO0RS 
1069 
1090 t 
1091 § Oet patterns fer charactera on tne TY sereent 
1032 1 Cheracter with code « $8 at offsere Sx (too line) to due? Chettew line) 
1659 i] Ge wrktes 1 © Dleck, no margine Between character epaces estner 
ae t wertically or horizontally 
1055 
O529* 00 tose CHRST § gefo ac00000008 i cade 20 epece 
Osza° 09 1057 def 00CI00008 
O828° 00 109¢@ defo O0oCcCOOdS 
OS2c° 00 105% defo 000800000 
ere a0 tee Gefo 090300005 
ae") 60 1061 defe 0O050000R 
osae’ 90 1062 @efe oo9300008 See APPENDIX C-2 for Character Set 
ADL = ASC CO} 40-COL.MOOE SUPPORT CRLGOZIL version 12.36.16 Le-Mer~Oe = 12263223 
CHARLSET FOR 0786 COL. RCOES cmsStad. Sac 
a @eserved arraytT 0039 aTTMSK cose ATTReP sceo 8 Reserved 
GOTLN 0020 ¢ Reserved caLcar 2480 CaALCAl OoFs caLcea 0487 
CaLcr2 OeT? Cweser 0429 Cwast 352¢ CmMTeL oogF CUINIt 1400 
CURCTL ooocc CLRSBO Ozer CLesce 2208 IN CLASCN 0253 IN cuLasco 0269 
CURSCL 0270 CLascas o2a8 CuRSca azec CLasce ozer CuRsces 0294 
Cuasc? O2c# CURSXT o2ca CONVEN pee? caaaos sero Ccuseos 6054 
+] Reserved OarTas 0906 OPAORS 0936 OrerrT ooze e Reserved 
gaaaey o13¢ GETABO O37E Getata core In GeEYatyT 0382 IN Gerceo 039¢ 
GETCTL 0019 Gcercus O021 IN GeTcur c39C IN Gcercs 0386 Gersra 060€ 
codore Ors GROLA 0226 GRPMST st29 GRPST oe29 cate. 0031 
CTCaar 0208 IN GTCHEO 0207 GTCmas o918 IN GTCMA O20 GTCmz O2F4 
GTCmz2 Ozfa GTCa23 0320 GYCH3 e31s GTCw3a o316 GTCH32 0342 
GTCms 0368 GTCMSs Q367 GICHe e377 GTCSHe 0520 G¥czec 0$13 
GTC263 Oste Grc2e2 0527 GTENOX 2034 GTSTR’ 0419 GTSTR2 Onet 
" Reserved TNITSS 0025 In TNITSO 7369 In twsoeu 0104 TwvPag 3i3e 
1S Reserved LOaTIR QeFO LOPosN seal LINCOL 0007 LINLEN 0033 
Lney OoTe Looe oie Loore o18i Loor. Oise ” Reserved 
MARGIN 0030 Magee 0038 masnep SC8E WEKTE oos¢€ NEXT2 o0ee 
MENT gids NOINVE 0133 worai ocs NORR2 QOEO wore 0100 
wOSTaG Oe31 NOXQR oocs Params scc3a PaRERR 06386 osu Reserved 
POrPLAG sC91 RECLEN 1720 SCINIT 3701 SCRCTL 0028 SCRLO o0za IN 
scacso Olaz scact oo2z€ SCaLxT e202 servo o1s¢ scacu 0246 th 
SCRSE oo18 Sercao O192 sercua 0309 In seTcur 0196 IN se Reserved 
sPareo oo SPOREL 0043 SPaRE2 oo1s SPARE3 oo17 SPaRrte 0026 
STOL6 022¢ STBLKO 0230 STBLKG 3231 STPOSN 6699 sTacct 0038 
resrao e3cc TsTear 0436 TSTPRL a03F TVFULG 01463 TveuLr ose 
vos scrTe uPdarT O6ag uroata ceac upoati oace UPoat2Z 0008 
uPoaT3 Oses ueoros 0452 vars stes vVIpeggo 5CC2 WRC WAR 0063 IN 
wRCwae 0001 IN WACuKT olsT wacnd 3340 who. 0646 WROMAL o0es 
wRCm12 0060 wacais ooTL WARCHI6 3287 wRCnis ooes weaCn2 o06e 
wary O08 WRENS OosP waCne ooa8 wacn? 0120 waSTLeP O170 
WRSTRE 0008 In WRSTRG 0160 In wasTRo o169 WRSTRE O27a wWRSTx2 oases 


Ne@ errora detected 


Croce reference lieting (MREF version 4.7) 


Syepek fefe (8 © definition 8 © srite <Celenk> © read) 
arrverrT Alle 347 955 101668 

avinsa 11%8 as? 10208 

arrale ate = 401? 

atyn ase 296 7678 

caucas 1008 1oide 

cavcar os? své T3090 982 10016 
Carcez 902 906 

caLcea 622 7T29 ers bese 

cuaser ade 103 79 

cnasT oo 10560 

CuTeu 1030 as2 623 rede 

CLINIT gee 176 

CLaCcTL T30 git rrse 

CLRSB0 oi) s10e8 

CuRsco a71 923 S2te 


CURSCL Sece 39? 
CURsc2 sate 

cuascs 3820 406 
Cuasce S540 $73 
cuaescs See 

CLascT gat e008 
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Cuasce 


eneaet 
Gertaso 
eerars 
cerary 
Gercs 

Gercad 
Serer. 
GETcus 


eatcue 
Gersre 


Caren 

Gtczg. 
Risit} 
ercsse 
GTCms 

GTCr2 

6TCraz 
GTCnrs 
GTCm) 

GYCmss 
GTCms2 
GTtue 

GvCms 

aTCné 

oTCr 
attr 
GtCwee 
GTCSne 
CTEmoE 
orsTan 
GrsTe2z 
Turred 
imtvses 
tnsoe 
tuvean 


Loarre 
LOPosN 
tIecoL 
LINLeN 


intu 
wage 
.oare 
Osea 
MARGIN 
waSae 
maASK le 
meats 
wentz 


sarced 
sercus 
SeTcur 


sveu« 

STOLKQ 
STOLLER 
STPOSN 
sTRGcT 
vastao 


726 146 esze 

9338 oye 

7038 

aye 

4a? 206 ave 2008 2038 
oase T1488 126 713398 9068 
ore ones oes 1035 

308 

7998 

Wrz 7Teae 7e%8 

392 Sze 796 

ran 

700 rezs 
1O3ke 

716 

sete 

666 este 

oa2 ore oor 

Tose 

2908 389 sae 39¢ viv 
322 aes 

sav 10130 

7558 78668 Tote 

396 $32 745 Tris 793 
062 004 

o63 9100 

ate 

939 10238 

ave yese 

3968 

3068 3098 rees 

300 

395 sz9 796 tos 12 

328 

WTts rres 

303 
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725 Gele 


106 


oTle 
ores 


399 rer 6736 


wacei2 
wnCniyd 
WACALS 
wacnls 
waCnz 

aacnys 

Rms 

WACHE 

wacar 

wRCHAR 
aetna 
waACnIT 
WASTELP 
WASTRG 
wasray 
WRSTts 
WRSTEG 
WASTER 


is3e 


APPENDIX C-4 


DUAL SCREEN MODE 


Neme: Qual Screen Mode Support 
Description: 


This component provides support to the application programmer for 
using the dual screen capability of the TS 2068. The services 
include opening/closing the secona display file (moving the 
machine stacks, CS RAM routines and BASIC structures), position 
control, clear screen and scroll screen services, and display of 
characters. In acdition, services are provided to control which 
display file ais active at the screen ang which is the terget of 
the current screen operation, as well as a Copy Service and an 
Exchange Service to transfer screen data/sttributes within or 
tetueen the teo display files. "Get" services are provided to 
return the current disclay position, the character coce for ~a 
specified ditolay positions, or the attribute oyte for a specified 
display posation. 


“or ease cf use from BASIC, status is returned in the BC register 
pairs usually zero tor successful completion and designated 
non-zero values for other conaitions. The interface from BASIC 
as by means of POKE"ing the input parameters to aesignated RAM 
locations prior to invoking the service via the USR function. 
See pege « of the code listang for the memory addresses to be 
usea trom BASIC wath the supoort cose loaded starting at Chunk 7 
CEQOON/ST 346). 


Attribute and other disclay controls such as Inverse are taken 


from the standard 152062 System Variables (see Usage Section.) 
The system variable VIOMDC 183 used to determine which display 
frle is the target of the requested service. 


Nawe: SETMGOE CSETMODA trom BASIC - paraneter to VIMCDED 


Ineut: 
mBCE 9 . Normal (Oxsclay File 1 only) 
128CB8OnN)s CFL Active (0&2 Open) 
1 . CF2 Active 
4 . Screen Operations to DFI 
5 s Screen Orerations to OF2 
From Machane Coce: Mode Parameter in & 


From BASIC: Mode Parsmeter in VIMODE 
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Descrantion: 


Mode values of 0» 1286 of 1 will cause an update of the video mode 
Raroware and the opening er closing of the second displey file as 
neeced. This involves deteraining if there is enough tree RAM to 
Open the second eisplay file end if go, meving the BASIC 
structures end aechine language variables ares up and tne UdG 
Cuser-Defined Graphics) sres down to aske space fer the machine 
stack and OS MAM routines at the top ef aenory. The second 
Gasplay file sas clesred to zeroes. The sttected systes and 
anternsl varasdles are updsted or initialized (aoe Maage 
Section). When returning to Mode 0 the structures are returned 
to their normal locations. In these modes the designated Display 
File is active st the screen and is the target of all screen 
Orerations. 


The moce values of 4 and 5 go not stfect the herdeare, but are 
usted to redirect screen operations to the desired display tale. 
Tris permits buslding of a display file prior to activating 1% at 
the screen. 


Tre screen position 38 set to “mowe” (Cline 0/7€01.0) whenever 
SETMOUE CSETMO3) a8 executed. 


NOTES All screen orerstions of the TS 2058 System SASIC 
Interpreter inclusing prograr entrys, System Fesseges,s 


LIST, PRINT, PLOT, DRAW, etc. work only in Disslay 
File 1. 


Name: CLASCN CCLRSCS from BASIC = parameters to CLSCTL? 


Ineut: tine Count (1-24) 
Sterting Line Number (0-23) 


From Machine Coce: Line Count In Register B 
Sterting Line In Register C 


From BASIC: Starting Line Nueber in CLSCTL 
, Line Count in CLSCTL © 1 


Cescrirtion: 


Clears to background color (PAPER) the designated number ef 
lines, beginning with the Starting Line Number. Line 0 with o 
count of 24 clears the entire screen. Upon return, the cursor 
position de at the beginning ef the first line cleared. 


Outeut: BC » 0 for successful coapletion 
OC © 1 dnvelid paraneters 
Chine Number ¢ Line Count ¢1 or 326) 


Ware: SETCUR CSETCUE from BASIC = parameters to LINCOL) 


Input: Laine Number (0-23) 
Colvan Number (0-31) 


From Machine Code: Line Nusder In Register & 
Column Number In Register C 


From BASIC: Column Mumber In LINCOL 
Line Numper In LINCOL ¢ 1 


Description: 


Converts the requested position te internal formats, detereines 
display file address, and stores the valves for use by the next 
dieclay character operstion. Nete that once established, the 
position is updated sutomatically when & character is displayed 
so that 1t is only necessary te set the position shen sequential 
disclay is not desired. 


NOTE: The screen position used snd saintained by these service 
routines is independent of that used by the System ROM 
C$ POSN). 


Gutput: 8C * 0 for successful completion 
6C «= 1 for invalid par ters (Line Number > 23, 
Column Nuaber > Line Length-1) 
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Nawe: WRCHR CwRCHB from BASIC - paraseter to DATAB) 


Input: Character code for character to be discleyea 


20m 7C TM = Sed. TS2068 Character Set 
BOM TD BFm = Std. Graonics Set 
90M TD AGH = User-Defined Graphics Set 


From “acnine Code: Resister A 


Feom BASIC: in DaTas 


Sescriction: 


Jasplays charecter st current cursor position, apelying current 
attributes and ask. “aves cursor position on to next seauential 
cosition. If character would start a nee line after BOTLN Cree 
Usage section) and the scroll count (variable SCALCT) decrements 
to zero, the character will not be disoleyed and return will be 
made with BSC + 3 Cscreen full). If the scroll count does not 
Cecrement to zeros the screen e1ll be scrolled up one line using 
tne information in SCRCTL and the new line started at the vacated 
line. 


Jutputs 8C = 0 for successful completion 
SC = 3 invalid character code 
2C 2 3 for sereen tull 


Names WRSTRG (WISTRE from BASIC = String Identifier an PARAMS) 


Inputt Crarscter Code String 


From machine code: Acdress of string in HL 
Count am BC 


from BASIC! String Variable Icentifier in 
System Variable PaRaus = 23767 CSCC3HD 


Cescription: 


Cisclays the characters from the string, beginning at the current 
Cursor lecation and continuing sequentially until the count 
expires, or “Screen Full” {8 detected (see WPCHR oescription and 
Usece Section on Automatic Seralling). For the Sereen Full 
CONdition, the remaining count is stored in the internal veristle 
STRGCT for access by the user. 


NOTE: Characters within the string which are outside of the 
Supported range C32 through 164 (C2Z0H-AGH)D ) wil] be 
ignored. E.gey @ASIC Token codes snd contre) codes 
ewbedoed in an INPUT string will not be displayed or 
decoded. 


From BASIC, PCRE the code for the string variable identifier into 
PARAMS Drior to invoking WRSTRE, e.¢e 


0005 LET stehannmnngtringeennno® 

0030 POKE 23747,CODE "a" 

0015 IF USR CWRSTRBEICIO TREN on--- 
(continue) 


8C a G Successful 

3C = 2 BASIC = Strang not found 

QC #3) Screen Full - Remaining Count in STRECT 
CmlLeCurrent aceress in Strang) 


Ovteut! 


Wame: SCROLL (CSCRLB from BASIC - parameters to SCROTL) 


Input? Line Count (1-23) 
Starting Line Number (1-23) 


From Machine Code: Line Count In B 
Starting Line In € 
Frew BASIC: Starting iidne In SCRCTL 
Line Count In SCROTL « 1 
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Description: 


Serells the designated nuaber of lines up 3} position, starting st 
the specified line nunber and inserts a blank line at the better 
of the sercllee eres. Line 1 with @ count of 23 ofl] screll the 
entire screen up 1 line. Upon returns the cursor positien is at 
the beginning ef the inserted blank line. 


Note: See Usage Section on ‘automatic’ serolling. 
Outgout: OC © 0 Successful 


BC = i Invalié Pareneters 
Cline Number ¢ Line Count ¢ } er > 24) 


a i ed 


Mane: GTCHAR CGTCHRS frow SaSIC - parameters te GETCTL) 


Input? Line/Colvan position as tor SETCUS 


Frea Machine Cede: Line Mumber in 6 
Coluen Nusper in € 


Frew BASIC: Ceoluan Number in GETCTL 
Line Number in GETCTL + 2 


Description: 


Returns in register C ef the 8C register pair the character code 
for the character at the designated screen position. If ne satch 
against the chersecter set Cincluding the stenderd and 
user-defined graphics) is feunds zere is returned. (Character 
coee of zere alse returned in A.) 


Wete: Positions “printed’ using the OVER technique will return 
zere if they de net match sgainst any single cherecter. 


Jutput: §8C = 0 tor ne find 


SC = 1 invalid pacsseteors 
BC «= character cede (20h-A46H) 


Mame: GETATT CGETAYB from SASIC - parameters to GETCTL)D 
Input: As fer GTCHAR 


Description: 


Returns in register C of the 5C register pair the attribute dyte 
for tne character at the designated screen position. 


Duteut: 8C = 1 for invalid perseecters 
BC = attribute byte 


Sit 7 - FLASH 
Bit 6 = BRIGHT 
Bit $ 

Bit 4 - PAPER 
eats 7 

bat 2 

Oat 1 - INK 
eat as 


a 


Name: GETCUR CGETCUB from BasiC) 
Input: None 


Description: 

Returns in the BC register geir ano in the BASIC porsacter 
lecetion LINCOL, the current print position Cuhere the next 
character would be disolayes). 


Qutput: @ © Line number (0-23) 
C = Coluen musber (0-31) 


BasTcs LINCOL = Column nuaber 
LINCOL ¢ 1 = Line number 


NCTE: If the last character was printed at Cal.31 of Line 
23 Clast position on the screen), then Col.O/Line 23 
will be returned. 


weeenrnenewnenerenen eee ereee ees ese ewwr eee ezcereca 
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POR Wo oO OBS O 8 OS Bee Oot Bee ew ees Bete ewes cee meeeBoeee teseerere 


Name: COPYSC CCOPYSE from BASIC = string identifier in PARAMS) 


Inout: 
Source Line (0-23) 
Destination Line (0-23) 
Source Display File €1 or 2) 
Destination Cissley File (1 or 2) 
Lane Count Cle24) 


from Machine Code: Seurce Line in 6 
Destination Line in C 
Source OF in D 
Cest.DF in E 
Line Ceunt in A 


Froese BASICS Parasaters in string variable, separated by cennas. 
String Identifier in System Variable PARSNS = 297467 
csccan> 


Oescriptien: 


Copies the designated cortien of the source display file te the 
ated pertion of the destination dierlay file. The seurce 
end destination msy be in the sane di ay file. Ouring «8 
@ulticline cepy, seurce and destination eperands ere accessed in 
a tep to bottom fashion, therefores in certain cases ef eperand 
everlep the eperation easy be destructivert.e. the seurce dats 
may be modified befere it is cepted. Te get the desired results 
4t way be necessary to copy individual lines. 


Free BASIC, the fellesing exeaple would copy lines 6 thru 20 fre» 
OF te lines 0 thru 12 in DF2: 


LET 982"8,051,2513" OsSterting Line 
Oedestination Line 
LeSource OF 
2e0est.DF 
L3sLine Ceunt 


POKE Z23747,CCDE "am CString Toentifier te Pahans) 
LET ccwuse CCOPYSe) 
TE COCO THEN coc cnccceres 


Butput: BCad Successful 
BCel Invalid Parameters CCFCD] of 23 Line No.€>0-231 
Lane*Count¢rl-26 
BCe2 BASIC = String wot Founo 


Name? EXCHSC CEXCHSS feor @aS5IC} 


Tnout: Source “1° Display File C1 of 2) 
Seurce “1° Line (0-23) 
Source °2° Displey File C1 or 2) 
Seurce °Z° Line (3-23) 
Line Ceunt (1-24) 


Frew Aachine Code? Seurce °1° OF in 6B 
Source “1° Line in € 
Seurce °2° OF in Oo 
Source °2° Line in & 
Line Count in a 


Free BASIC? Paresetere in string variables, separated 
by coe oe in the order Source “1° Lines 
Source * Lines Source “1° DF, Seurce °2° 
CF, Line Count. String Identifier in 
Systea Variable PARANS ~ 23767 (5CC3N) 


Oescrictiens 


Exchanges the specifies nuadber eof lines between Source “1” and 
Source °2°. Both Sources may be in the se Oiselay File. The 
exchange is dene by KOR°ing the twe seurces tegether three tises. 
The operation is dene @ line at » tise, accessing the tue seurces 
in 8 tep te Bettem fashion, e.g. te exchange lines 8-12 in OF 
with lines 16-20 in OF2 sould first exchange line @ COF1> sith 
Line 16 COF2)»_ then line 9 with Line 17 and proceed in this 
fashion through exchange ef line 12 sith Line 26. 


From BASIC. the folloeing exseple seuld exchange lines @ thru 4 
in OF1 with lines 8-12 in DF23 
LET 88270,8915255° "1° Line 
"2° Line 
“1° oF 
2sS$eurce °2° OF 
SeLine Count 


OsSource 


PONE 23747,CO0E “a* CString Icentitfier te PaRams) 
LéT ceeusSe CExCHS3) 
TH COED THEN scccccccccane 


Sutput? OCHO Successful ’ 
OCs) Invalia Parameters (DFC>1 of 23 Line Now¢t>0-233 
LaneeCount ¢>1-24 
CCa2 @ASIC ~ String Not Found 
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Ae es 


ee ) 


Usasei 
Mesory Usage? 


Tris package eof machine code reutines includes the fellowing 
internal veriebles: 


Name Size Oescriptien 
SCRCTL 2 Serell Centre) 
LSO = Starting line nusber 
WSO © Number ef lines to be serellee 


BOTLN t Bottom Line - Line nueber (0-23) after enich 
test fer scroll aill Be ande. 


SCRLCT 1 Screll Count- Nuaber of times ¢ 1 that 
eutesatic screll sill be dene. 
When decresented te rere, date 
will net be displayed and a 
condition cede eill be returned 


te user. 
CwrTen 2 Character Table (fase sddeone-100H) 
GRTBL 2 Std.Graphics Cheracter Table (8ese-100H) 
LINLEN i Line Length 
cumecs 2 Current Position (Internal Format) 


LS$8 * Coluan Position 
MSB © Line Position 


OFACOR 2 Current Oisplay File Address 


MASKE 1 Working Byte - CP FLAG Shifted Right 1) 
Coit O = OVER ? 
Coit 2 © INVERSE) 
Coit 6 s INK Complement of PAPER 
Coit 6 & PAPER Complement of INK 


aTTervT i Working fyte ~ (Copy of ATTR ®) 
GTINOX 1 “Get” Ingen - Used by GYCHAR 
STRGCT 2 String Count = Contains remaining cyte count 


when €Cud (Screen Full) is 
returnes from tre write String 
Service WASTRE CWRSTRAD. 

ATIMSAK ] Working Byte = (Cosy of MASK ®) 


Initiel values set via SETHCOE CSETMOB) when the secong ciseley 
file is first opened ere as follows: 


Varioole Nene Value 
SCRCTL 17014 
BOTLN 17K 
SCcELCY 16 
CurTar 3000n 
GeTer CInterneal te Mogule) 
LINLEN 20m 
CugPos iazin 
DFaDOR 4000%76000N 
GTIWCE Son 
syvecct On 


Tne follewing ere the variables used tor paeesing parameters in 
basic. The © ndicates these initialized by SETHDS ehen the 
second display file is first epened: 


Variable Nene Size Value 

» O2Tae i On 

® LINWCCL 2 on 

@ CLACTA 2 1000H 

@ GETCTL 2 on 
VIMOOE 1 


In sddition, VIONDD, PARAMS and other system variables aust be 
available to tnese revutines. a4 pindiaua, chunks C-3 and chunk 7 
must be enabled in the Home Sank. 


Location: 

This package can be incerporatec into 8 sachine code osregras 
sithin the esesery rence frem chunk 4 threugh 7. taking inte 
censiderastion the reespping of certain structures when the second 
Gisplay file is epen 


NOTES Machine cede sbove RAMTOP is not aoved. 
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Registers: 


Other then as documented for output velues, no claims ere esce a8 
to preservation of any resister conterts excerct for the i¥ 
Register which sust aleays contain the velue 5C34m for secess to 
the standsera system variacies,. 


Automatic Scrolling: 


As initielized, test for scrolling will be sade ashen the erint 
@osition goes to the next line following the bottom line on 
screen CBOTLNEZ3e26th bined. Concition Cede 3 (Screen Full) #11] 
be returned since SCRLECT will decreeent to zero. If SCALCT is 
Set to sone larger values, then the per ters in SCRCTL will be 
used to autematicelly scroll the designated number of lines 
beginning at the specified line nurter. As inmitialized, this 
will scroll the entire screen up. Sy perferming a PGKE er 
setting the verisbles BOTLN end SCRCTL to the desired valuess 
automatic screlling can be Gene using smaller sections ef the 
screen. When werking frem BASIC it 48 recommended that BOTLN de 
set to Line 21 CI5M) ane SCRCTLO1 be set to 21 CASH) to eveid 
conflict with the Eait Line which uses the sottos tee lines ef 
the screen. Note that once SCRLCT expires, it will be set to i. 
Tt a different value is desired. it pust be reinitialized by the 
user after receiving the “Screen Full’ cencition. 


By setting the SCRCTL variable and inveking the SCROLL CSCRLBD 
Foutine any portion of the screen way be scrolled at any tine. 


Attribute Control: 


Attribute and sesking CInverse/Gver) control inforsstion #ill be 
taken from the system veriables ATTR_ PP, MASK_P and P_FLAG as 
Gefined below. These variables contain the “permanent” attribute 
controks set vie the BASIC commands PAPER, INK, BRIGHT, FLASH, 
INVERSE, ang OVER, or by directly eriting to the specified 
locatiens. 


NAME SODRESS CONTENTS 


ATTRLP 23693 Sit To - FLASH 
6 = ORIGHT 


wasn P 236946 SAME FORMAT AS ATTR_P, 
USED FOR “TRANSPARENT’ 
CISPLAY: 
For each bit that is set 
to ls the correstonding 
intormation will pe taken 
from the current screen 
pocition imetead of tron 


atte 6. 
Sit 
FLFLAG 23697 T PAPERSCOPPLEMENT OF INK 
S$ INKOCOIPLEMENT OF PAPER 
3 - INVERSE 


1 - CVER (Nee Characters 
ZOR°@ with O14) 


Usang System RO" Screen Services? 


The following tecnniauve can be used to build screens using the 
fasIC comeands such as PRINT, PLOT, CIRCLE, and ORAW or etner 
System 20" reutines end get thea inte the second display files 


1. Set Mode BO Copens 2nd DF) 
Ze Build Screen in OF} using Systee or 
ADL Services 
3. Copy CF2 te DF2 using COPYSC (CoPYss)> 
4. Set Mowe 8 (OFZ to Screen) 
Se Set Node 4 COF2 at Screen/Operations te DF1) 
6. Build Screen in DFI using Systen er 
aOL Services 
7. Set Mode BO COFL to Sereen) 
&. Go te Step 3 


The seitching of the screen frees ene cispley file te the ether is 
transparent to the vieser shere the files contain the seme date. 
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waeelas 


when the second display file is active at the screen, any systen 
ages such as SCRCLL?, error reports, or use ef the INPUT 
comeand will not be visible snd the systee aay appear te be 
"hunge. Indascrisinately pressing keys say be filling the 
“anvisible” Edit Line with “garbage’ thus further aggrevating the 
situation. The ON ERR facility can be used te intercept save of 
these situations and set the vieee sode to use Disslay File 1 at 
the screen in order that the ae ge can be en and responded 
te. Otherwise, it is necessary to key in and execute frea tre 
fait Line without deing eble to see ite 


ADL - ASC 066 CUSL SCREEN MODE SUPODRT CRIGSZEI version 15.36.16 LerMar-86 = 32347336 
VERSION LEVEL COMTROL 2OOS.SRC 


a mate ADL — ASC O04 QUAL SCREEN MOOR SUPPORT 
2 ' 
» 64 
e t 
§ t 
4 8 
? : 
6 ‘ 
9 3 
‘ Poaseovessscecesesousssesessssecoss 
1 ® ® 
' s Timex s 
: @ APPLICATION C2VELOPMENT Lreaaay @ 
i] s . 
5 @ WAMET DUAL SCREEN MODE SUPPORT & 
$ id ® 
i @ ASC mWOt O64 e 
t @ VEGQSTON: 661 . 
' @ auTmcRt C. CORtORAN e 
t i ® 
' * 
SuGTT. VERSTON LEVEL COntagL 
i] 
‘ 
8 veestce Gate Comments 
1 eeaeenee sone oar ae ae ow Ot 
‘ 
4 eel 170766 ORT6TNAL 
t 
SUGTTL CEP INITIONS 
s 
3 
’ 
1 SOROCEPINITIONSeeen 
’ 
INTERN §=WACHAR,WRSTRG, SETCURSCLASCN, SCOCLE 
INTERN CTCHAR,GETATT GETCUR 
INTERN = wRCHRB,WASTRE,SETCUSSCERSC9oSCRLS 
INTERN GTCHRB,GETATALGETCUS 
INTERN = SETMCOE,SETHDS 
INTERN COPYSC,COPYSS 
INTERN EKCMSC,EXCHSS . 
1 
9016 SCRSI 2 t 26 LINES 
wEras SCENET U7TOIM =. § SCRORG COmTROR INITIALIZATION 
23606 Curnit? 1800" 3 CUEAR SCREEM CTL. INtT. 
Cnaser 3COOM = &s REM CHAR. TAOLE-100" 
2osea° GROWST CCOMPSTI-100M) TSTO.GRAPMICS CHARS, 
‘ 
sore CunGvIO CfSEN «=6¢ ROUTINE IN ROM ZRTENSTON 
e3720 RECLEN 1TZ0OM # ROUTINE IN HOME ACH 
a30r9 INInt 3OF 9M = t ROUTINE In WOME aCe 
#3193 p28 31934 = ROUTINE IN HOME ACH 
’ 
=Corr MRERPT €3u Oren 3 MCmME ROM EXT.SELECT PORT CSIT 7) 
o0rs ORMSPT f2u OFen 3 OOCK MORIZOWTAL SELECT PORT 
1 
eSCoe vaas Fou SCoBM «6s SYSTEM VARIABLES 
#3Cs0 CH_apo etsy scsom = 5 
#5Ces STKRENO ecu Sscs5m os 
osc7s 54 scram ot 
©5070 gu scton 
#500 Qau scsow , 
=5cee #30 scuem 4 
escoi ecu ScOiIn t 
fou sce2n 
#5086 €su SChom 3 
oscc2 vIOmMo0 es scc2m 3 
escc3 PaRans tou SCC3# = CLOCATION 23767) 
ontves tsu eason 3 
IWSERTSZ €su TedCH-ORIVES 
MOVEST fou ORTVES-6000% 
sPTCO oEsTr €au OF FFON-MOVESI ol 
@97co Pix #su GOESTT-a000" 
#2000 PIRTOL eau 1000" 
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ez SUSTTL INPUTS AnD EWTAIES 


es 
eo 68 
st 
ao 
er ' 
ee iy 
oo ot SOPARAMETER INPUTS AND ENTRY POINTS PROM BaSICee 
90 y 
mu 64 write 
oz 3 MOOULE L0A080 
3 63 aT $7344C8000m) 
ew 68 Cecrman soomess 
so ecwesce ae 
g000° 20 ge 8 =« bares oere zon 1 CATA OYTE PROM Baste ST3A6 
e001" Cy 0046" or whCn@es ae wand 2 ENTRY TO wRite CHaRacTeR $7965 
eooe” C) aoge’ oe 8=6wasTaet a WASTRO 3 ENTRY TO wOITE STRING 7309 
bad ' 1 Coes PARAMS above) 
6007" 0000 100 Linco cerw t) 1 SET CURSOR PaRameTERS 
101 # —LINCOLSCEL. CO<31) s7ssa 
102 # — LINCOLoamL ING (O-23) S752 
gooe" C3 on?” 103 sarcues ‘ld SEYCOO 8 BNTAY TO SET CURSOR POSN. 8697958 
eooc’ 1006 toe cuncte Tid) 2000 «§ CLEAR SCREEN CONTROLS 
109 8 —- CLARCTLeSTARTING LINE NO. $7356 
306 2 CURCTLOLOL ING COUNT a7357 
oooe°’ C3 ot00e° 107 crescer rid CLASOG 8 ENTRY TO CLEAR SCREEN s7sse 
goss? 0900 106 «= SPAREO oerw 9 t NOT USEO CALIGNMENT ONLY) 
ao33" o0e0 199 = $Panel ceew C] ’ 
001s’ 2000 310 0 $PARER ceew t) ’ 
oar’ 0000 224 Spaney cere Q ' 
0039* 0000 t2200 Gerer. cer C) 3 °GET*® CONTROL Pan BASIC 37369 
323 t FORMAT TS aS POR LINCOL 
oo1e* c3 ozsc’ 1360 GTCHRO: rd GYCmOQ 4 ENTRY TO GET Cranacten S737. 
oox#° ¢3 O20C° 1s) GeTater a Gevaso § Entay TO Get aTTRIaure S73T6 
oo21" C3 a2#1° 12600 GETCUs: pt GETCHO of ENTRY TO GPT CURSOM SOSN. = SI3TT 
ooze* 00 aa? Viwcoe ores (] a VIOEG MODE CONTROL s7300 
Coat’ «C3 0308" 128 | SETMOR? ae $TmO8O =f ENTRY TQ SET VIED MODE srye. 
ooze’ Aves a2e) so ScReTL ceru AVORmM 8 SCROLL CONTACL 
120 ts SCACTLOSTARTING LINE NO, STI84 
tai 1 SCOCTLOLOLING COUNT s73es 
oozae C3 o1ar’ 222 SCALOL ‘ld SCRLBO & ONTAy TO SCROLL s7yae 
way 
124 1COPYSS t Untey TO COPY eRam OF s7408 
aas os t CSQG NEXT Pace 
22600 FEXCHSO t ENTRY TO EXCHANGE SCREEN grain 
aa? i) 1 CSQE NEXT Pace) 
iz0t 
130 SUGTTL CTMER VARTASLES 
431 i] 
132 1 
33303 
1368 
eoz0° «637 435 OOTiN cere avn @ GOTTOM LIME CUlwe aerge s730¢ 
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Oxcnds 
*e2a 
GervarT 
Gere, 
Gatvan 
oares. 
GyCuae 
GTCn33 
GTINOX 


SCINIT 
$cauxt 
setcus 
SETNOZ 
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GTsTay 
orstaz 
MREKOT 
ININT 
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LoPaosn 
Gtncce 
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Laoore 
4o0r) 
masas 
masn_e 
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RECLEN 
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Ste.se 
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SPRITE GRAPHICS SUPPORT 


Weme: Sprite Graphics Support 


Oescrartaon: This cosponent provides support for sprite 
graphics. A srrite is # graphical object which can be 
created and ranipulates by a set of services to be described 
Selow. 4 sorite can be up to 256 « 256 characters in size, 
however st most 32 x 26 can be displayed. Each sprite is 
adentified by a sprite-ad, a number greater or equal to 
zeros anc has the following properties? 


defaniticn - a cointer to a width x height character 
bitmap, enere width and height sre user defined. A 1 
andicates toreground color, a 0 inaicates background 
color. 


eagsatigo - the row, col location on the screen of the 
wecer left corner of the sprite. 


Galec - the screen attribute Cfoereground color}. ry 
value of 0 indicates blacks, 1 andicates blue, etc. 


Raze - the wadth and height of the sprite Cin 
characters). 


The sprites graphics package assumes that the system 
variavles area of memory is not used by an applacation. The 
sprite support services can be invoked from machine code ang 
BASIC. There is a BASIC interface routines which tekes as 
its parameter a SASIC string variable. Tne BASIC interface 
anc sprite services code is loadec at SPRCOCE, where SPRCCOE 
2 OECOCH. The name of this variable is specified by poking 
in the starting character st address SPRCODE-«. For 
exsmplers if PQKE SFRCODE-4, CODE "C™ is executed, the 
variatle CS #ill ce used to pass commands to the interface 
routine. This aust be sone before using any sprite 
services. The interface routine is invoked by LET 
<wariable> # USR SPRCODE. The status code returned by the 
last sprite service executed is essigned to <variable>. 


The BASIC interface routine causes the report “A: Invalid 
argument” to te gsroducec whenever an illegal command or 
invalids araurent to a command is found. If too fees or too 
many arguments are jiven for some command, the report "Q: 
Ssrameter error” is produced. If the command string 
variable cannot be founds, the report *Ct Nonsense in BASIC" 
is produced. If tnere is not enough memory for the nuaber 
of sprites scecifieds the report "62 Dut of memory" is 
Produced (see InitSprites). There exists a variable called 
COMMAND, at asodress SPRCODE-S, which contains the number of 
the last sprite command to te executed. Thus if an errer 
cccurs in & sprite commands this variable can be PEEKed to 
fing out which command in the command string caused the 
error, The first command in the command string is command 
zero. 


The machine code routines all return status codes in the 8C 
register pair. If the value in C is 0. then no error 
occurred. In this case B contains a value indicating 
turther status information. If an error occurreds C will 
contain an odd value (thus bit 0 is set}. 


Tne BASIC interface string variable contains sprite graphics 
Commands, separated by spaces. The comasnds have the 
following syntax: 


"Ccommand ietter><parameter list>® 


where “command letter> is a single upper or lower case 
letter identifying the command! 


Init Sprites 
InitScreen 

Create Sprite 
Set_Autourap Mode 
Put_Sorite 


Erase _Sorite 

Move Sprite 

Change _Sorite_ Location 
Crange_ Sprite _ Attribute 
Overlap? 

Horizontal _Scerol) 
Vertical Seroll 


<rTroree rm venue 


and where <parameter list> 1s a list of numbers separated by 
commas. The string assigned to C% can be a strang 
ORDFOSSLiONS L.Ge2 "CSUDSTFO"OSTRECCoupr dd o*Csubstrr™. The 
semantics of these commands will be deseribed in detail 
below. 
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Aetiicasagd Saecuices 


Name: Init Sprites 
Machine code interface: 
Inputs! & © mox-sperites, 0..2$8¢ 


Guteute: BC © OCO00m = GK 
® O0003n = not enough memory 


Entry: SPRSVC © SPRCCDE « 2139 


Basic antertace: 


Inputs? LET C8 © "Icmanr-sorites>® 


Oescrietion: This service initializes the date structures 
used by the sprites services. Memory ianediately beles the 
Sprites code is used fer glebsl varisbles end senery 
immecistely below this is used to store sprite inforastieon. 
Each serite takes up @ bytes of data (not including its 
Gefanition, ehich is sterec elseshere). Thus the total 
amount of memory used by the sprites rackage iat 


8 bytes * max-serites ¢ 29 byte globsais eres + 2746 byte 
code ares 


If there 1s not enough memory between RAMTDOP ano the global 
veraables area tor the number of sprites specified, OO01h is 
returned. Thus, RANTOP shuold be set to 

SPRCCOE - 29 - 8 man-sprites 


before calling InmitSorites. This service must be calles 
before any of {ne others. 


BASIC evemple: "132" initializes wsemory tor 32 sprites. 


Name: Inat_Screen 
Machine code anterface: 


Inpute: €@ © screen heights, 0.226 
0 ® peekground_color, 0.27 
€ = border color, 0..7 


Outputs: @C = O0COR - OK 
= 600TH = dliegsl screenht 
= 9005n = illegal coler 


Entry: SPRSVC © 200" 


Basic interface: 


Inputs: LET Cts 
"Scscreen_nt>eCoack ground _color>,Coorder_color>® 


Description: This servace clears the tep screen_ht lines of 
the screen and sets their coler te the background color, 
The bottom 2é-screen ht lines are cleared and set te the 
border color. The tep sereen_ht lines are used fer 
Cisplaying sprites. The remaining lines can be used for 
text display. The border is set to the boroer celor. 


BASIC exomecle: "S22e5e2" clears the top 22 lines and sets 
their color to cyan, clears the vettos two lines and sets 
their color te Slues ane sets the border celer to blue. 
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Wame: Create Sprite 
Machine cede anterface: 


Inputs: @ © sprite-id, O..max-sprates - 1 
® = wadth, G.0255 

C © heagnmt, 0.6255 

0 * colors 0..7 

Cf] 


L = definition aderess, 0..60K-1 


Dutputs: BC = O0000h - OK (sprite created) 
= 0003h - illegal sprite-ia 


Entry: SPORSVC @ SEH 


BASIC interface: 


Ipputs: LET Cs « 
WCCsorite-idrs<width>d,Cheight>s<color>s<ader>* 


Description: Tris service creates a sprite with the 
specified wicth, height, color, and definition address. 
Initially, the position of the sprite is (0, 0). If there 
was alreacy a sprite with the specified id» it is destroyed. 
In #11 furtner operations the new sprite is iaentifies by 
its sprite-id. 


BASIC example: "C0e20252532768" creates sprite 0 which is 2 
« 2 characters in sizes is red in color, and whose 


definition as located at 32768. The initial position of the 
sprite is (Os C). 


Wame: Set_Autowran_ Node 

Macnine code interface: 
Inputs: A = mode: 0 - off, not 0 = on 
Qutputs: BC s 0000m - OK 


Entry: SFRSVC + BOM 


BASIC interface: 

Inputs: LET CS = "wimode>" 
Description: This service turns the dutosrap mode on and 
off, when the Autowrap mode is en, sll changes to a 
sorite’s location sre made so that the new location is on 


the screen Ceracaround). 


BASIC example: "Wi" causes Autowrap rode to be turned on. 


Machine code snterface: 


Bt Spriterids Ge.auesprites = 3 
O = row, 02.288 
Ee column, G.22558 


inputs: 


Ovteuts: BC s OCOOM = OK, nothing oversritten 
C10On = Ck, something overwritten 
O003n = illegal sprite-ia 
D = row 
€ © coluan 


Entry: SPRSYC + EEX 


Basic interface: 


Inputs: LET C8 © @Pcaprateridds<roersCcolumn>” 


Oescraption: This service writes » sprite en the sereen. 
The row and colusn described shove define the location at 
which the upper left corner of the sprite is eritten. if 
the  utoerear mode 48 set, the roe and column values are 
modified ta make sure that the sprite location is 8 legal 
sereon location. The ree rew and coluan valves are 
returned. If the Autowrap mode is not sete the positien is 
Rot changes. Mowevers only those parts of the sprite 
corresconcing to legal sereen positions will be displayed, 
if wrtting the sprite causes semething on the seraen to be 
overwritten, the eeprepriate coce is returned. 


BASIC example? "POsi1-0" outs sprite 0 at roe il, coluen 6. 
anvthieg already at that location is oversritten. Tf 
anything 18 overeritten, the anterface rovtine returns 10h. 


Nase: Erase Scorite 
Wachine code interface: 
Inputs: & © sprite-id, O..mpx-sprates - 1 


Outouts: BC = O000n - OK Csprite erased) 
OOO3h = illegal sprite-id 


Entry: SPRSVC «+ 198% 


BASIC intertace: 

Inputs: LET C8 = @E<sprite-id>® 
Descrintion: Tras service erases a sprite. The sereen 
Becomes blank ehere the sprite used to be. The sprite still 
exists and can be eritten elsemnere. 
GasiC exemele: EO" erases sprite 0. the sereen lecations 
taken up by the sprite become blank. 


Wame: Move _Spriate 
Machine code interface: 
sprite-id, G..max~sprites - 1 


as 
0 = relative vertical wrotiom, ~328..127 
E = relative horizontal sotion, -128..127 


Inputs: 


Cutputs: SC = O000h - OKs, nothing overwritten 
0100h - OK. something overwritten 
0003h - illegal sprite-ic 

0 = row 
—€ = column 


Entry: SPRSYC + 200n 


@ASIC interface: 


Inputs: LET CS = PMCseriteridd s<Cvert><hor>* 


Description: This service moves a sorite. The sprite is 
erased at its current location and written at a new location 
defined by: 


hew row © old roe ¢ relative vertical motion 
new col = old col ¢ relative horazantal sotion 


Tne location of the sprite is updated to reflect the motion. 
As with the "FP" command, if the sprite overwrites anything, 
20h is returned. If Autowrap mode is set, then the location 
is sutomatically wrapped to fit onto the screen Cicoos C245 
0) becomes C0» 02). The new row and column values are 
returned. If Automrar wode is not set, only those parts of 
the sprite which correspond to legal screen locations will 
be displayed. 


BASIC example: “M0,2,0" changes the position of the sprite 


from (11, 0) to (13. Cd. This operation is equivalent to 
"EO PO0,13,0". 


Machine code interface: 
Inputs: & * sprite-id, 0..max-sprites - 1 
Oo = new row, 04-255 
E = new column, 0.2255 


Dutputs: BC = 0000n - OK Clecation changed) 
O00O3nh ~ illegal sprite-id 


Entry: SPRSVC ¢ 237 


BASIC interface: 


Inputs: LET C8 © "L<sprite~id>s<new-reeds<nemcol>® 


Description: This service updates the position property of 
a sprite in the same fashion as for Put _Serite. The sprite 
is mot updated on the screen wntil a Move Sprites 
Put_Sprites or Erase_Sprite is executed. 


BASIC example: "00,1350" will set the location of sprite 0 
to €13_— 0). 


Name: Change Sprite lattridute 
Mecnine code anterface: 


Inputs: & © speiterid, O..max-sprates = 1 
OQ = color, 0..7 


Outputs: BC = O0000m - GK Ccelor changec) 
O003n + iklepal sprite-io 
OOOfm = iblegal color 


Entry: SPRSVC «© 240m 


Casic anterface: 

Inputs: LET CS = PACBDritesiddsCcolor>* 
Descriction: This service uodates the color croperty of a 
sprite. The sprite on the screen is not vodated until @ 
Put_Serites Move Sprite, or Erase Sprite is executed. 
BESIC example: "A0.2" causes the coler property eof sprite 0 


to be set to red. 


a ey 


Newe: Overlap? 
Machine code interface: 


Inputs: D0 © sorite-id-1, O.omax-sprites - 1 
€ = sorite-id-2, O..max-sprites - 1 


Outputs: BC s D900n - OK, no overlap 
O200h = DK, overlap 
0003h - illegal sprite-ic 


Entry: SPRSVC ¢ 268n 


BESIC interface: 

Inputs: LET C8 & “D<snrite-id-1>s<eprite-id-2>" 
Descriotion: This service is used to detect if tue sprites 
overlap. 

BASIC exaaple: "O0e1" causes the interface routine to 


return TES if serates C and 1 overlap on the sereen. 


corer ener ewe eee eee we eww eww wm we wwe enw ew wwe 


Names Vertical Scroll 
Machine code interface: 


Inputs: & = direction: positive number = down, 
negstive number - up 


Outputs: @C = 0O09h = OK 


Entry: SPRSYC «¢ S58N 


GASIC interface: 


Inputs: LET C8 = "¥<direction>®* 


Descrintions This service is used to scroll the entire 
screen in the vertical direction by one ros. The direction 
of scroll is uo if direction is less than 0, othersise the 
scroll is down. The position property of ai] sprites is 
updated by one row to reflect the effect of the scroll. <) 
Autowrap mode is not set, then 1 is added to the row value. 
If Autowrap mode is set, then 1 is added to the roe values 
and this new value is erapped to fit on the screen. 


BASIC example: "VI" causes the screen to scrolled gown one 
TrOBe 
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Naves Worizortal Scroll 
Machine code interface: 


Inputs: A © direction: positive number - rights 
negative mumber - left 


Outputs: BC = 0000h ~ OK 


Entry: SPRSVC « 380n 


BASIC interface: 


Inputs: LET C8 & "KCdirection>d" 


Gescription: This service is used to scroll the entire 
screen in the morizontal direction by one column. The 
Girection of scroll is to the left if direction is less than 
0» othersise the scroll is to the right. The position 
property of a1] sprites is updated dy one coluan to reflect 
the effect of the scroll. If Autowrap mode is not set, then 
1 is added to the column value. If Autowrap mode is sets 
then 1 is added to the column value, and this new value is 
wranped to fit on the screen. 


BASIC example: “H1" causes the screen to scrolled right one 
column. 


CaOIwy CRLO0/11 version 16.26.38 V3-Feb-as 1638238 
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APPENDIX D 
TS2068 PCB Assembly and Schematic Diagram 
The following Appendix contains the PCB Assembly Drawing, the 
PCB Parts List, and PCB Schematic Diagram (a "fold-out" page 
located just inside the back cover). The Table below contains 


some corrections to the Schematic Diagram. 


***TS2068 PCB Schematic Diagram Corrections*** 


Page 34 of the Technical Manual shows pin 9 of the joystick 
ports grounded as it should be. The traces were left off the 


TS2068 PCB. 

VR1: U3-33 goes to VR1/Q5 

Q4: Connect base to R55/R54 

Solder dots on horizontal lines below keyboard: 
U12-4 to U3-65 (WR) 
Ul12-5 to U3-66 (MREO) 

U5: U5-2 to U3-38 (A7R not A7RB) 

Pl: P1-4B +15V (not -15V) 

U21: 
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TS$2068 PC BOARD COMPONENT LAYOUT 
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DESCRIPTION 
.B. abrication an 


rtwor 


CAP. 0.1 uf, Ceramic, Axial 


TEMP Z5U 


CAP. 0.01 uf, Ceramic,Axial 


CAP, 0.001 uf, Ceramic, Axial 


CAP, 0.047 uf, Ceramic, Axial 


CAP. 20pf Ceramic Axial 
CAP. 39pf Ceramic Axial 
CAP. 43pf Ceramic Axial 
CAP. 56pf Ceramic Axial 
CAP. 75pf Ceramic Axial 


CAP.120pf Ceramic Disc 


CAP.470uf, 25V AL Electro- 


lytic Axial 


CAP. 1 uf, 16V MIN AL Electro- 


lytic Axial 


CAP. 47 uf, 16V MIN AL Elec- 
trolytic Axial or Radial 


CAP. 1000 uf, 12V MIN AL 
Electrolytic Axial 


CAP. 1000 pf, 50V MIN FILM 


MYLAR 


CAP. 100 uf, 10V MIN AL Elec- 


trolytic Axial 


CAP. 6-50 pf, TRIMMER 


CAP. 0.47 uf Ceramic Axial 


CAP. 33 uf TANTALUM 


APPENDIX D 


TS2068 PARTS LIST 


COMPONENT 
DESIGNATION 


C2,7,9, 16,24, 30 


31,34,35,37,39,43 
44 ,48,49,50,51,52 


53,54,55,56,57 


C11,12,14,33,61 
62,68,69 


C8,45,46,47 
C10,15,74,75 
C23 

C20 

C19 

C25 

C32 


C59,63,64,65,72 
73 


C3 


C21 
C41 
C40 
C36 
C58 ,67 
C5,18 
C60 
C71 
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QTY 
PER ASSY 


23 


COMMENTS 


-20 +80% or GMV 


-20 +80% or GMV 
TEMP Z5U 


-20 +80% or GMV 
TEMP Z5U 

-20 +80% or GMYV 
TEMP Z5U 

-20 +80% or GMV 
TEMP Z5U 

NPO 

NPO 

NPO 

NPO 


-20 +80% or GMV 
TEMP Z5U 


LOW ESR 
+/- 20% 


NPO 


-20 +80% or GMV 
TEMP Z5U 
+/- 20% 


DESCRIPTION 
pt Ceramic Axia 


CAP. 24 pf Ceramic Axial 


CAP. 47 pf Ceramic Axial 


RES. 300 OHM, 
RES. 200 OHM, 
RES. 100 OHM, 
RES. 240 OHM, 
RES. 68 OHM, 
RES. 680 OHM, 
RES. 390 OHM, 
RES. 1K OHM, 


RES.1.5K OHM, 
RES.1.8K OHM, 
RES. 620 OHM, 
RES. 2K OHM, 
RES. 3K OHM, 
RES.2.2K OHM, 
RES. 110 OHM, 
RES. 510 OHM, 
RES.5.1K OHM, 
RES. 10K OHM, 
RES. 13K OHM, 
RES. 20K OHM, 
RES 62K OHM, 
RES.100K OHM, 
RES. 220K OHM, 
RES. 75 OHM, 


RES.1.10K OHM 
RES.3.32K OHM 


RES. 10K OHM, 
RES. 330 OHM, 
RES. 56 OHM, 


1/4W, 
1/4, 
1/4W, 
1/4W, 
1/4W, 
1/4, 
1/4W, 
1/4W, 


1/4W, 
1/4W, 
1/4W, 
1/4W, 
1/4, 
1/4W, 
1/4W, 
1/4, 
1/4W, 
1/4W, 
1/4W, 
1/4, 
1/4W, 
1/4W, 
1/4W, 
1/4W, 
1/4W, 
1/4W, 


VARIABLE, LINEAR 


0. 5W, 
1/4W, 


RES. 0.110 OHM, 3W, 


Wire Wound 
RES. 20 OHM, 
RES. 82 OHM, 
RES. 22 OHM, 
RES. 680K OHM, 
RES. 47K OHM, 
RES.390K OHM, 
RES.6.8K OHM, 


1/4, 
1/4W, 
1/4, 
1/4W, 
1/4, 
1/4W, 
1/4W, 


+/-5%, 
+/-5%, 
+/-52%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 


+/-5%, 
+/-5%, 
+/-5%, 
+/-52, 
+/-5%, 
+/-52, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-5%, 
+/-1%, 
+/-1%, 


+/-5%, 


+/-5%, 


CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 


CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
CF 
MF 
MF 


CF 
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TS2068 PARTS LIST 
(continued) 


COMPONENT 
DESIGNATION 


C29,27 
C28 
R23 


R19,50,54,55 


R58 


R24, 28,56,57 


R2 
R13 ,68 
R74 


R11,33,34,35,36 


38 42,62 


R31 


R16,40,60,70 


R26,27 
R44,45 
R9,73 
R15,49 
R43 
R46,67 
R6 

R5 
VR1,2,3 
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QTY 
PER ASSY 


Omn=—fho po 


=NMH WHA] NHS] NY NND PH SB Se es es et i pg 


Cie 


COMMENTS 
-20 + or 
TEMP Z5U 
-20 +80% or GMY 
TEMP Z5U 
-20 +80% or GMV 
TEMP Z5U 


APPENDIX D 
TS2068 PARTS LIST 


(continued) 
COMPONENT QTY 
DESCRIPTION DESIGNATION PER ASSY COMMENTS 
11,12,13,14,15,16 
17,18,19, 20,21, 22 
23, 24,25, 26,27 ,28 
DIODE, Schottky 1N58217 or CRI ] 
equivalent 
IC, UA 78840 NPC, Switching Ul 1 
Regulator 
IC, SCLD U3 1 
IC, LM1889N, Video Modulator U4 ] 
IC, 74LS244N U5 1 
IC, ™S4416-15 (150NS) MOS U6,7 2 
Dynamic RAM 
IC, UA 78L12 Regulator U8 1 
IC, 74LS245 u9,15 2 
IC, 74LS157N U10,11 2 
IC, T™S4416-20 (200NS) MOS U12,13,17,18 4 
Dynamic RAM 
IC ,AY-3-8912, Sound Gen.and U14 1 
1/0 Port 
IC, 23128 Mask ROM (16K X 8) 16 1 
IC, CPU Z80A u19 | 1 
IC, 2364 Mask ROM (8K X 8) y20 1 
IC, 74LSo0 U2] 
TRAN. PNP D43C1? Q1 1 
TRAN. PNP 2N2907 Q3 1 
TRAN. PNP 2N3904 Q7,8 2 
TRAN. PNP 2N2222 Q5,4,2 3 
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DESCRIPTION 
ter er ‘ 


Inductor 230 uh 

Inductor .33uh Axial 

Inductor .12uh 

Crystal Oscillator 14.112 MHz 


Crystal Oscillator 3.579545 
MHz 


Switch SPDT, Rocker 


Switch Channel Select, 
SPDT Slide 


Video Jack Insulation Pad 


Jack, Right Angle RCA Video 
Jack 


Jack, Mini Phone, EAR & MIC 


Jack, COAX, DC Power, 2 1/2 
MM Pin 


Jack, Phono 

Connector,Cartridge 2 X 18 
Pin 0.1" Space 

Connector,Flex Cable 14 Pin 


Connector Joystick 9-Pin Male 
(D Type) 


Shield, R.F. Button 
Shield, R.F. Top 


Heat Sink 
Heat Sink Insulation Pad 


APPENDIX D 
TS2068 PARTS LIST 


(continued) 
COMPONENT QTY 
DESIGNATION PER ASSY COMMENTS 
L2 ] 
L3,4 2 
L6,7 2 
Yl 1 
Y2 ] 
SW2 J 
SW 1 
1 Under J7 
J7 1 Monitor 
J2,3 2 Tape 
J 1 
J8 1 Assembled to 
Shield, R.F. 
J4 1 Key between 
Contact 4&6 
J9 ] Keyboard 
J5,6 2 Joysticks 
] 
1 
HS1 ] 
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DESCRIPTION 
ocket, : m 


Socket, IC, 40 Pin 

Speaker, 45 OHM, Mylar Cone 
Jumper Wire 

Ferrite Bead 


PC Board Assembly,Daughter 


APPENDIX D 


TS2068 PARTS LIST 
(continued) 


COMPONENT 
DESIGNATION 


WI, 2, 50 
L5,8 
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QTY 
PER ASSY 


mm WW 


COMMENTS 


APPENDIX E 


Expansion Buss Comparison of 
TS2068, Sinclair Spectrum and ZX8l 


TS 2068 SPECTRUM 2X-6i 
BOTTOM TOP BOTTOM JOP BOTTOM TOP 
GND 
SPKR/ TAPE 
15 v 
Sv Sv 
N.C. 9v RAMCS 
PWR GND Ov 
PWR GND Ov 
CLK CLK 
Ao Ao 
A, A, 
Ae Ae 
As 7 @ A; < 
A,,8 oS w As WT Oy 
Ay8 o = aaa 2 
AgB Ay HALT 
Aw Ae REG 
Ay A TORG 
Aw Ao RO 
A, A, GR 
Ae As BUSAK 
Ay Ay WAIT 
Ae Ae BUSRO 
As A, RESET 
A, A, Mi 
N.C RONCS RFSH 
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August 1985 
Bob Orrfelt 


TS2068 MODIFICATIONS FOR EPROMS 


There are a number of errors in the TS2068 Home ROM and the Extension 
ROM. The errors can be corrected by using EPROMs. The following 
modifications are necessary: 


aa 
jumper 
gaia, J 
thee 
fae 76 


Non-component side of the pcb, 
0. Remove ROMs. 
1. Cut the trace between U20-26 and U20-27 
2. Jumper pins 1 to 28 to 27 on each socket. 


Gu To Ul6 pint 
Cac? trace Lo ° id 


a 8 
wy} / we 


wr OTe Ue peril 
D 


Component side of pcb. 


3. Remove the two zero ohm resistors Wl and W2. 


4, Cut the trace just above and to the left of hole A. 

5. Add a jumper from hole A to the trace. This connects MREQ to 
U16 pin 22. 

6. Add-a jumper from hole C to hole B. This connects ROMCS to 
U16 pin 20. 


7. Use a 27128 (16K) EPROM for U16. 
8. Use a 2764 (8K) EPROM for U20. 
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October 1985 
Bob Orrfelt 


Proposed TS2068 Home ROM Corrections and Improvements 


35F9 FFFFFFFF blanks 


3SFD FF 
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NMI fix. 
9@6D 25301 JR Z,2870H 
DELETE delay timing. 
eae ne Le oh a USR chunk selection 
‘ Cc g we a) Wel eiu ® 
9355 73 Lo Ac SSSF ESso - AND sOH 
@356 Ba oR B S3AL 2315 JR 2; 8BEH 
@357 20FB JR NZ,@354H 33A3 0549 SUB OA,40H 
@359 Fi Pop AF 33A5S FAB?33 JP M,2887H 
®83S5A 18De JR B32EH 
ix Fe Liger EPR agramer., 

Optional turn on message. ee eens 
{Last character add 82H: @@2B 34 “DB 34H 
1118 Property of Bob ae2c 37 DB a? 
1128 ore fe Lt asap ezezueres 82D SB DB @BH 
1133 seep unpeneuasepeunueeunes G@Q2E SBD DB SDH 
1146... @@2F 92 DB 32H 
INT -65536 etc. errors. 
Sort ES ead ae More For EPROM programmer. 
SGF2 3¢ INC A 37BS Do xX 
Bees BS Ae 5 37B9 212500 LD HL,e8e2BH 
33F5 C2E435 JP NZ,35E4H eee Be ates a 
S3F8 CSEFSS JP SSEFH 3°BE SE LD CL THLD 

» tHLI 
35E>2 181A UR 35FEH S7TBF 25235 LD HH. 38H 
SSeS 77 CD THL) A 37c1 DS EXX 

c : 37C2 AF xOR A 

35E6 23 INC HL eee eo las 
35E7 7 LD (HL) ,£ g7tg ¢ nao 
35E8 23 INC HL 37C4 82 NO 
35E9 72 LB (HL) G 
SSEA 2B DEC HL 
SSEB 26 DEC HL 
SSEC 28 DEC HL 
SSED D1 POP CE 
3SSEE cs RET 
SSEF Fl POP HAF 
SSFO 2B DEC AL 
3SSF1 3691 Lo tHL) .S1H 
3S5F3 23 INC HL 
3SF4 36ae LD (HL: , 3@H 
3SF6 3C INC A 
SSF? 18ED dR SSE5H 


NOTES 
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BRUNING 44-131 22870.3 


2 RESTRICTED INFORMATION 


+5V ] 1.0 AMP 
C44 pF 


CORE-TOK 


UA7TBL12 +EE13Z 


1000,F 
CR1 INS621 


4“A78840 
SWITCHING VOLTAGE 
REGULATOR 


Tice-3a) 


“WE gycr2s },,, pugs 


va c73 Ri1 
sai C8 INa148 - 
LOO1ur T1209 1K (6? a Sor craze. peak PuA=27, 


= IN4 148-2 


(RS 1-3A) 


“USE OF THE TECHNICAL INFORMATION CONTAINED HEREIN IS AT USER'S 
SOLE AISK. WHILE THE INFORMATION WAS BELIEVED TO BE CORRECT AT 
THE TIME IT WAS PREPARED, TEX COMPUTER CORPORATION OR ITS 
AFFLIATES, ASSUME NO RESPONSIBILITY OR LIABAITY FOR THE SAFETY 
OR PERFORMANCE OF ANY PRODUCT MANUFACTURED RELYING ON THE 
TECHMICAL DATA CONTAINED HEREIN, OR ANY LIABILITY, LOSS, DAMAGE, 
SIGNAL OR EXPENSE SUSTAINED BY REASON OF ANY CLAIM THAT SUCH PRODUCTS 
GND INFRINGE ANY PATENT OR OTHER INDUSTRIAL PROPERTY RIGHT.” 


NOTES: (umess OTHERWISE SPECIFIED) 
1) ALL RESISTORS ARE 1/4 W, 5%, RATED IN OHMS. 
2) ALL CAPACITORS ARE RATED IN MICROFARADS. 


3) FOR DA@N26C. INSERT W1 & W2. 
OR INSERT W3 & W4 (NOT USED) 


IN4148x8 
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WeSe argc jc 


eee 


OPERATION 
7 
4 cs6 
ie 


pF 
7ais24s |2o HPV 


CHANGES 


16 RESHE PIA-26, 4-32 
17? MREQB PU-17, J4-18 
ORQG PIA-18, 14-19 


13 WRB PIA-20, 34-23 


RDB PiA-19, J4-21 
13 A138 PB-16, J4-4 
A145) PW-15, Je-1 


P-14, 14-16 


KEYBOARD 


7 Pe-28 


GREENE. 


c7a c10 
t20pF L osm 


«pit —t_T, ri 
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; 
Tate 


OPT (2.22 yr 


VIDEO IN/RF MOD MAS 
CHROMA OUT/VIDEO 


Sara en ee 


R26 
13K 
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fea s79545MHz 63K 
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a 


bl 


2364 8Kx8 
MASK ROM 250NS 


PLAYER 1 


TOK-BEAD 


#BFO3-3.5x5x1.0x2 y 


SIZE & TOL 


PHY SPEC 


PIA-27, J4-34 
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LAST USED 
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